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

Optional. gpt-image-2 output size. If omitted, derived from aspect_ratio (1:1→1024x1024, 3:4/9:16→1024x1536, 4:3/16:9→1536x1024). Explicit size always wins.

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

aspect_ratio?string

grok: exact output aspect. gpt-image-2: used to derive size when size is omitted (previously silently ignored).

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"

watermark?

Optional brand watermark. Starter+ plans only — free-tier keys get a 402. Provide EITHER text OR logo_url. Defaults: bottom-right, 65% opacity, white-on-dark text legible on any background.

Response Body

`application/json`

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"  }'

{
  "success": true,
  "data": {
    "id": "meme_7xK2p",
    "url": "http://example.com",
    "template_id": "string",
    "model_used": "string",
    "prompt_used": "string",
    "width": 0,
    "height": 0,
    "format": "png",
    "file_size_bytes": 0
  },
  "meta": {
    "request_id": "req_abc123",
    "credits_used": 0,
    "credits_remaining": 50,
    "processing_time_ms": 432
  }
}

Empty

Authorization

Request Body

Response Body

200application/json

422

503

`application/json`