Developers

Animix API & MCP

Animix inside your product

Designs, videos and 3D booths from a few words, made by the Animix Director. And the strongest thing we have: everything comes fully editable, from A to Z — every scene, word, picture, motion, voice and caption. Videos run up to an hour in the browser, and with no limit in the desktop app.

How it works

  1. Your server sends a brief with your key.
  2. The Animix mind makes the plan on our servers: the story, the scenes, the words, the look.
  3. Your user’s own device renders it, with the Animix player in your page. Nothing heavy runs on your servers or ours.
  4. Your user edits anything in the Animix editor: in a new tab, or inside your own page with a Business agreement. When they press «Done», the result comes back to you.

You choose the editing way once, for each key, below. Every request with that key then works that way by itself.

What it costs

The same credits as Animix itself, charged for every try:

A design
1 credits
all its sizes
A video
2 credits
every 15 seconds (a minute is 8)
A booth
25 credits
renders, film, PDF, build files

Editing and rendering after that are free and unlimited, on your user’s device. («You pay only for what you keep» is Animix’s own gift on our site, where we see the keep; through the API every try is charged.)

🧪 A test key
30 credits to try it — enough for a booth, a video and a design. The results carry the Animix mark. Every Free account has one set of test credits, whatever keys it makes.
⭐ Pro and Premium
Your key draws from your plan’s credits, with no mark. Premium has higher request limits. Upgrade on the plans page and your keys follow at once.
The plans →
🤝 Business
For platforms that put Animix inside their product: a lower price per credit as the volume grows, a monthly invoice, a 99.9% uptime promise, the Studio inside your own page (without our mark, by agreement), and a person from our team for you.
Talk to us →

Your keys

Loading…

✍ Made by the Director: review before you use it

Everything the API and the MCP make comes from the same Director we improve every day, with new styles, skills and fixes as they come. Like any automated tool it can still make mistakes, so every result comes fully editable. If you offer results to your own users, tell them the same: they are made automatically, and they should look them over before they publish them.

When something fails

A failed try is never charged. Each one is shown on its key with its reason, so you know what to fix on your side:

rate_limitedToo many requests today for this key’s plan
no_creditsThe credits ran out
bad_briefThe brief was missing or unclear
plan_failedThe Director could not make a plan from the brief
scopeThe key is not allowed to use this
render_failedThe render failed on your user’s device
webhook_failedYour server did not answer our «done» message

Ready now, and coming

ReadyKeys, test credits, credits per try, the live use and failures of each key
ReadyThe video plan from a brief (storyboard)
ReadyThe MCP server on our domain: any assistant connects with the address and your key — a video plan, a design, a booth, your credits and projects
ReadyDesigns and booths through the API: prepared for your account, opened there filled in
ReadyThe edit link (a new tab) and the «opened» and «done» messages to your server, signed
ReadyThe status page: every part of Animix, checked every five minutes, its 90 days and its incidents — /status
ReadyInside your page (Business): the Animix player, which makes and renders the work on your users’ own devices, and the Studio to change it first — one script, sdk/animix.js

Quickstart

A video plan from a brief
curl -X POST "https://YOUR_DOMAIN/api/v1/storyboard" \ -H "Authorization: Bearer ak_live_…" -H "Content-Type: application/json" \ -d '{"idea":"a brave lion helps lost animals","durSec":30}'
The answer carries «credits»: what the try took, and what is left on a test key; and «edit»: a link that opens the plan in your account, in a new tab, to change it and build it in the Studio.
A design, or a booth, prepared for your account
curl -X POST "https://YOUR_DOMAIN/api/v1/design" \ -H "Authorization: Bearer ak_live_…" -H "Content-Type: application/json" \ -d '{"brief":"20% off every cake on Friday","type":"offer","sizes":["1x1","9x16"],"language":"en"}' curl -X POST "https://YOUR_DOMAIN/api/v1/booth" \ -H "Authorization: Bearer ak_live_…" -H "Content-Type: application/json" \ -d '{"brand":"Nile Coffee","brief":"a counter and two screens","width_m":6,"depth_m":3,"sides":"corner"}'
The answer carries «open»: a link that opens it in your account, filled in, to check and make. Nothing is taken for preparing it; «credits.onKeep» is what keeping the result uses.
Your key, its limits and its credits
curl "https://YOUR_DOMAIN/api/v1/me" -H "Authorization: Bearer ak_live_…"

🪟 Inside your page (Business): the player and the Studio

With a Business agreement, set a key’s editor to «Inside my page» and give it your pages’ addresses in the dashboard. Its answers then carry «play» — Animix makes the work and renders it on your user’s own device, inside your page — and «embed», which opens it in the Studio to change it first. Each link lives one hour and opens only on your pages; POST /api/v1/embed { id } gives fresh ones.

<div id="animix"></div> <script src="https://YOUR_DOMAIN/sdk/animix.js"></script> <script> const view = Animix.mount(document.getElementById('animix'), { url: answer.play, height: '720px' }); view.on('rendered', () => console.log('made on the user’s device')) .on('file', (m) => upload(m.file, m.name)) // the file itself, as the user saves it .on('done', (m) => console.log('kept', m.result)); </script>
Keeping the result uses your account’s credits, and your server hears «done». Your users need no Animix account.

📮 The «done» message

Give a key your server’s address in the dashboard above, and Animix tells it about the work that key prepared: «opened» when it is opened in Animix, and «done» when its result is kept — downloaded, exported or published. Each message is a JSON POST, sent up to three times, with no personal data in it:

POST https://your-server.com/animix/done X-Animix-Event: done X-Animix-Signature: sha256=<HMAC-SHA256 of the body, with your signing secret> {"event":"done","id":"h…","kind":"video","title":"…","at":1760000000000,"key":"ak_live_ab12","result":"…"}
Check that it came from Animix (Node.js)
const crypto = require('crypto'); const want = 'sha256=' + crypto.createHmac('sha256', SIGNING_SECRET).update(rawBody).digest('hex'); const got = String(req.headers['x-animix-signature'] || ''); const ok = got.length === want.length && crypto.timingSafeEqual(Buffer.from(want), Buffer.from(got));
Answer with any 2xx. If your server does not answer, the failure shows on the key’s day as «Your server did not answer our «done» message».

🔌 The MCP server, for any assistant that speaks MCP

It lets an assistant use Animix as tools with your key: make a video plan, prepare a design or a booth, and see your credits and projects. What it makes opens in your own Animix, to check, change and make. Add it to your assistant’s settings:

{ "mcpServers": { "animix": { "type": "http", "url": "https://YOUR_DOMAIN/api/mcp", "headers": { "Authorization": "Bearer ak_live_…" } } } }
Its tools: make_video_plan · make_design_brief · make_booth_brief · my_credits · my_projects. An assistant that only takes a link can use https://YOUR_DOMAIN/api/mcp?api_key=ak_live_… — keep that link private, it carries your key.
Through the MCP the work opens in your own Animix, so Animix’s own rule holds: trying is free within the day’s limit, and a credit is used only for what you keep.

The Director gets better every day. Like any automated tool it can still make mistakes, and everything it makes is fully editable: please review it before you publish or use it. Learn more