API & MCP

Use Wandcast and Persona Studio from your own code and AI agents. One key and one MCP connection cover both, with the same models and the same credits as the pages. Treat a key like a password: anyone who has it can spend your credits.

Loading your keys…

Use with Claude, ChatGPT and other AI agents

Add one custom connector (MCP server) with this URL. It brings both Wandcast video tools and Persona Studio tools. You'll sign in with ClipIdea and can set a daily credit limit for the app; it then shows up in your keys above, where Delete disconnects it.

https://clipideaai.com/api/mcp

Claude: Settings → Connectors → Add custom connector.
ChatGPT: turn on Developer mode, then Settings → Apps & Connectors → Create, with OAuth.
Code and other agents: send a key as Authorization: Bearer wc_live_….

claude mcp add --transport http wandcast https://clipideaai.com/api/mcp

Quickstart: Wandcast videos

Pick models: GET /api/v1/wandcast/models
Start a batch (up to 8 videos): POST /api/v1/wandcast/generations
Poll every 5-10 seconds until every job has done: true, then download videoUrl.

curl -X POST https://clipideaai.com/api/v1/wandcast/generations \
  -H "Authorization: Bearer $WANDCAST_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-batch-001" \
  -d '{"mode":"create","prompt":"A paper boat sailing down a rainy street, close-up",
       "models":[{"id":"MODEL_ID","count":2}],
       "settings":{"aspectRatio":"9:16","resolution":"720p","duration":5}}'

curl https://clipideaai.com/api/v1/wandcast/generations?batch_id=BATCH_ID \
  -H "Authorization: Bearer $WANDCAST_API_KEY"

GET /api/v1/wandcast/account shows credits left and your limits.
Modes: create (text or a photo URL in refs.photo), recast (Copy Motion: refs.motion video plus a character, outfit, location or product image) and swap (refs.motion plus a prompt). References are public https URLs.
Send an Idempotency-Key header on every generate call: a retry with the same key never starts or bills a second batch.
Limits per key: 120 reads and 10 generate calls a minute, 16 videos running at once. A 429 comes with Retry-After.
Credits are reserved when a batch starts and refunded for any video that fails.

Quickstart: Persona Studio

Pick an image model, traits, a starter look or a motion: GET /api/v1/wandcast/personas/options
Create a persona (1-4 photos): POST /api/v1/wandcast/personas, then poll GET /api/v1/wandcast/personas/ID until done: true.
Make it move: POST /api/v1/wandcast/personas/ID/animate, then poll the returned batch like any video batch.

curl -X POST https://clipideaai.com/api/v1/wandcast/personas \
  -H "Authorization: Bearer $WANDCAST_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-persona-001" \
  -d '{"model":"google/gemini-2.5-flash-image","look_id":"fit-coach","count":2}'

curl -X POST https://clipideaai.com/api/v1/wandcast/personas/PERSONA_ID/animate \
  -H "Authorization: Bearer $WANDCAST_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-persona-hi-001" \
  -d '{"motion_id":"say-hi","models":[{"id":"MODEL_ID","count":1}],"duration":5}'

Persona photos use the same credits, keys and limits as videos.