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.

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.

template_id?string

Template to animate (its blank image is the init frame). Provide this OR image_url.

image_url?string

An https URL of one of your stored meme images to animate. Provide this OR template_id.

motion?string

One line describing the motion, e.g. 'the hippo blinks slowly and wiggles its ears'. Omit for gentle generic motion.

Lengthlength <= 500

resolution?string

Default"480P"

Value in"480P" | "768P"

Response Body

`application/json`

curl -X POST "https://api.createa.meme/v1/animate" \  -H "Content-Type: application/json" \  -d '{}'

Empty

{
  "job_id": "vid_AbC123xYz456",
  "status": "queued",
  "poll_url": "string",
  "estimated_seconds": 30
}