createa.meme
API Reference

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.

POST
/v1/meme/remix

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.

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
Empty

Generate brand-new image from prompt

Generate completely original imagery via GPT Image, then optionally overlay caption text. Costs 3 credits. The differentiator endpoint.

Animate a template or image (invite-only beta)

Turns a meme template's blank image (or one of your stored meme images) into a 5-second video clip using MiniMax H3 Max. Asynchronous: returns 202 with a job_id immediately — poll GET /v1/animate/{job_id} (~every 2-3s; most clips finish in 10-40s). A fixed system directive keeps the output true to the source image and keeps text out of the video (add captions after, as a static overlay). Popular template+motion pairs are cached: repeats return instantly as status 'completed' with cached: true for 2 credits. Costs 10 credits (480P) or 16 (768P), charged at submit and refunded automatically if generation fails. Beta access is per-key — ask us to enable it. Limits: 20 clips per rolling 24h per key, 2 jobs in flight, image_url restricted to createa.meme storage hosts.