Build animation generation into your own product

Create videos and game-ready animation assets through the public beta asynchronous API. Any verified account can create keys; generation uses the same account credits as the web app.

Open developer center Read the API quickstart Download OpenAPI 3.1

Official remote MCP

Public beta

Connect Codex and compatible AI tools

Use OAuth to grant an MCP client access to your AnimGen account without copying an API key. The client can discover models, upload images, quote costs, generate animations, and download owned results.

https://api.animgen.com/mcp

OAuth 2.1 with PKCE

Explicit spend protection

Connecting never spends credits. Paid generation still requires a short-lived quote or a maximum credit limit.

Connect to Claude

Claude opens with the AnimGen server name and URL prefilled. Review the connection and requested permissions before authorizing.

Read the MCP workflow and availability

API workflow

One request, complete animation output

Send a file ID, inline Base64 image, or public HTTPS image URL, then poll the returned animation until it reaches a terminal state.

Server-side authentication

Use an ag_live_ API key in the Bearer header. Keep it out of browser bundles, mobile apps, and shipped game clients.

Asynchronous by default

Creates return 202 and Retry-After. Poll the resource URL about every five seconds and reuse an Idempotency-Key when retrying.

Shared credits and clear limits

API work uses the same account balance. Registered access starts at 1 concurrent job, a 3-job queue, 3 creates and 60 other requests per minute; subscriptions raise these account-wide limits.

Useful defaults

No selection means the full generated video.
No output_formats means a spritesheet.
Transparent exports use the Alpha Key workflow only; the API does not remove arbitrary backgrounds.
Valid Base64 is persisted before a task is accepted.
Existing outputs remain available if a later stage fails.

Read the transparent PNG and Alpha export workflow

One-click cURL

The example intentionally omits selection and export.output_formats to use the defaults.

curl -X POST https://api.animgen.com/v1/animations \
  -H "Authorization: Bearer ag_live_REPLACE_ME" \
  -H "Idempotency-Key: character-run-v1" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "first_frame": {
        "type": "base64",
        "media_type": "image/png",
        "data": "<BASE64_DATA>"
      }
    },
    "prompt": "pixel art knight running, side view",
    "metadata": {"external_id": "character-run-v1"}
  }'

Core resources

POST/animationsOne-click video generation and animation export

GET/animations/{id}Poll status, credits, errors, and output assets

POST/video-generationsGenerate a preview video independently

POST/animation-exportsExport a selected video asset independently

POST/filesUpload a reusable PNG, JPEG, or WebP input

GET/modelsDiscover current model capabilities and valid values

Advanced two-step flow

Use /video-generations and /animation-exports separately when your product needs a review or editing step between generation and export.

Retry safely

Retry 429 and retryable 503 responses after Retry-After. Never invent a new idempotency key for the same logical create operation.

Outputs

Spritesheets, metadata, PNG frames, clip video, and Unity, Godot, Unreal Paper2D, or Cocos Creator packs are represented as downloadable Asset objects. Transparent outputs require an Alpha Key source; commercial use still requires paid entitlement under the Terms.

Ready to integrate?

Verify your email, create a key in Account Center, and start with the one-click endpoint. Subscribe later if you need higher limits.

Open developer center Compare higher limits