Ziztu credits and spend caps
Everything on Ziztu is paid in credits. The price of a result is known before it starts, and every paid API or MCP call carries a cap that the server enforces.
For AI agents: the documentation index is at /llms.txt, and every page here has a markdown version at the same address with .md added.
Updated
What a credit is
A credit is the unit Ziztu charges in. Plans and credit packs add credits to your account, and every result takes some of them: a first frame, a clip, a music track, a voice line, a Director message, a run of a Studio app. The credits are the same for the Studio, the API and the MCP server.
Start for $10 a month. Ziztu starts at $10 a month for 7,000 credits. The plans are on the pricing page.
See the price first
There are two ways to ask for a price, and neither starts anything:
dry_run: trueon a paid call returns the exact credits asquote.POST /projects/:pid/quote(thequotetool in MCP) prices an operation and lists every shot that is blocked, and why.
{
"max_credits": 2000,
"dry_run": true
}Returns { "quote": ... } and starts nothing. Drop dry_run to run it. The same body works on animate and music.
Your balance is GET /credits (the get_credits tool).
The caps the server enforces
These rules are in the server, not in the client, so a confused or careless agent still cannot spend past the cap.
max_creditsis required on every call that costs credits: first frames, clips, music and Studio app runs. If the price is higher, the call is refused before anything starts.- Above 5,000 credits, add
confirm: true. A bigger spend needs a second, explicit yes. - Ask the price first.
dry_run: trueor thequotetool returns the exact credits and starts nothing. The quote also lists any shot that is blocked, and why. - Retries are safe with an
Idempotency-Keyheader: the same key and body returns the first answer instead of running twice. - Scope the key. A key without
generatecannot start paid work. Make areadkey for an agent that should only look. - Revoke it any time under Settings, API keys. It stops working at once.
Rate limits are 120 requests a minute per key and 30 paid requests a minute. The errors page lists what each refusal looks like.
Which calls cost credits
| Call | Costs credits? | Notes |
|---|---|---|
| Create a project, read anything, apply a Director plan | No | Free to call. Applying the free actions of a Director reply adds the cast, places and shots. |
Director messages (director_chat) | Yes, metered | Metered by use and taken from your balance. |
generate/frames, generate/animate, generate/music | Yes | Need max_credits. dry_run returns the price. |
Studio app runs (/tools/:tool/runs) | Yes | Need max_credits. Raise the budget of a run with approve. |
| Script writing tools | Yes | The write_ tools take about 50 credits a run, given back if the run fails. Drafts and edits are priced before they run. |
| Export a film | No | The export is ffmpeg on your clips. |
Credit ranges by kind of result
The exact price depends on the model, the length and the size, and quote returns it for your choice. These ranges run across every model and come from the billing code, so they stay current.
| Kind | Result | Credits |
|---|---|---|
| Video | 5 second clip | 70 to 14380 credits |
| Image | One image | 20 to 750 credits |
| Audio | One track, song or voice line | 30 to 1490 credits |
The model ids and the price of each are on the API reference.
Retries without paying twice
Send an Idempotency-Key header on a paid call. A retry with the same key and body returns the first answer, with Idempotent-Replayed: true, instead of running again. Answers are kept for 24 hours. The same key with a different body is refused with idempotency_key_reused.
Other ways to use Ziztu
- The Ziztu Chrome extension turns any text you select on a web page into a micro drama or anime scene. Its privacy policy says what it collects: nothing.
- Ziztu for Notion sends a Reel Factory plan to a Notion board and updates each row when the reel is made.
- The connectors add Ziztu to Claude, ChatGPT, Codex, Cursor and Grok.
Frequently asked questions
How do credits work in the Ziztu API?
Every result costs credits, and the price is known before it starts: dry_run or the quote endpoint returns it, and max_credits caps every paid call. Above 5,000 credits a call also needs confirm: true.
How do I see the price before I spend credits?
Send dry_run: true with max_credits to a generate endpoint, or call the quote endpoint. You get the exact credits and nothing is started.
What is max_credits?
A cap you send on every paid call. If the real price is higher the call is refused and nothing starts. Above 5,000 credits you must also send confirm: true.
How do I check my credit balance by API?
Call GET /api/v1/credits with your key, or the get_credits tool in the MCP server.
Does retrying a paid call charge twice?
Not with an Idempotency-Key header. The same key and body returns the first answer instead of running again.
What does it cost to try?
Start for $10 a month. Ziztu starts at $10 a month for 7,000 credits.
More docs
- Ziztu API errors and rate limitsThe Ziztu API answers every failure with a JSON error that has a code you can switch on and a message you can show.
- Ziztu PlannerZiztu Planner brings the Script Writer and the Director into Claude and other MCP clients.
- Ziztu Reel StudioZiztu Reel Studio is an MCP server at https://getziztu.com/mcp/reel.
- Ziztu MCP toolsThe Ziztu MCP server has 30 tools. Here they are grouped by what they do, in the order an agent uses them, each with its…
- Ziztu YouTube StudioZiztu YouTube Studio is an MCP server at https://getziztu.com/mcp/youtube.
- Ziztu OpenAPI specThe Ziztu API is described as one OpenAPI 3.1 document at https://getziztu.com/openapi.json.
- Ziztu API quickstartZiztu has a REST API.
- Ziztu skills for agentsZiztu publishes two skills for AI agents under the MIT license: one writes micro drama series and episodes, the other writes…
Also on Ziztu
- Ziztu Chrome extensionSelect any text, right-click, and open it in Ziztu as a micro drama or anime scene.
- Ziztu changelogWhat changed in Ziztu, newest first, in plain words.
See the price first, then spend.
Start for $10 a month. Ziztu starts at $10 a month for 7,000 credits.