Edit or remix an existing image

AI image editing: outpainting, inpainting and remixing. Provide an image (URL or base64) plus a prompt. With `model: gpt-image-2` you can supply a mask whose transparent pixels mark the region to repaint — true outpainting. With `model: grok` the image is used as creative reference. Costs 5 credits.

Authorization

bearerAuth

AuthorizationBearer <token>

Before clicking 'Try it' or copying the curl example, paste your API key into the Authorization input field on this page. Format: cam_live_xxxxxxxxxxxxxxxxxxxx (the playground will prepend Bearer for you). Get a free key at the dashboard — 20 generations per month, no card required.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

prompt*string

What to do to / around the image.

Length1 <= length <= 2000

image_url?string

Public URL of the input image. Either image_url or image_b64 is required.

Formaturi

image_b64?string

Base64-encoded input image (optionally a data: URI). Max ~10 MB decoded.

mask_b64?string

Optional base64 PNG mask for gpt-image-2: fully transparent pixels mark the area to repaint, opaque pixels are preserved.

model?string

gpt-image-2 (default) supports masks and faithful edits; grok treats the input as creative reference.

Default"gpt-image-2"

Value in"gpt-image-2" | "grok"

size?string

Output size for gpt-image-2.

Default"1536x1024"

Value in"1024x1024" | "1536x1024" | "1024x1536"

aspect_ratio?string

Output aspect ratio for grok.

Default"16:9"

Value in"1:1" | "4:3" | "3:4" | "16:9" | "9:16"

output_format?string

Default"png"

Value in"png" | "jpg" | "webp"

Response Body

curl -X POST "https://api.createa.meme/v1/meme/remix" \  -H "Content-Type: application/json" \  -d '{    "prompt": "Extend this painting into a grand museum hall around it, gilded frame, marble columns.",    "image_b64": "<base64 png with transparent border>",    "mask_b64": "<base64 png, transparent where to paint>",    "model": "gpt-image-2",    "size": "1536x1024"  }'

Empty

Authorization

Request Body

Response Body

200

422

503