createa.meme
API Reference

Generate brand-new image from prompt

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

POST
/v1/meme/ai-image

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/ai-image" \  -H "Content-Type: application/json" \  -d '{    "prompt": "a confused cat staring at a laptop with deployment errors on the screen, dramatic lighting",    "caption": {      "top": "It works on my machine",      "bottom": "My machine was lying"    },    "model": "gpt-image",    "aspect_ratio": "1:1",    "style_preset": "meme_classic"  }'
{
  "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

Flagship: AI picks template + writes caption

Provide a prompt; the API picks matching templates, writes captions, and renders memes. Returns one meme by default. Pass `count: N` (1–12) to get multiple variations in a single call. **Billing is per-meme: cost = 2 credits × count**, so `count: 1` costs 2 credits, `count: 4` costs 8 credits, `count: 12` costs 24 credits. Synchronous — blocks until rendered (~3-15s). Response is an array under data.memes[].

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.