ziztu
Make a video

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: true on a paid call returns the exact credits as quote.
  • POST /projects/:pid/quote (the quote tool in MCP) prices an operation and lists every shot that is blocked, and why.
POST /api/v1/projects/:pid/generate/frames
{
  "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_credits is 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: true or the quote tool returns the exact credits and starts nothing. The quote also lists any shot that is blocked, and why.
  • Retries are safe with an Idempotency-Key header: the same key and body returns the first answer instead of running twice.
  • Scope the key. A key without generate cannot start paid work. Make a read key 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

CallCosts credits?Notes
Create a project, read anything, apply a Director planNoFree to call. Applying the free actions of a Director reply adds the cast, places and shots.
Director messages (director_chat)Yes, meteredMetered by use and taken from your balance.
generate/frames, generate/animate, generate/musicYesNeed max_credits. dry_run returns the price.
Studio app runs (/tools/:tool/runs)YesNeed max_credits. Raise the budget of a run with approve.
Script writing toolsYesThe write_ tools take about 50 credits a run, given back if the run fails. Drafts and edits are priced before they run.
Export a filmNoThe 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.

KindResultCredits
Video5 second clip70 to 14380 credits
ImageOne image20 to 750 credits
AudioOne track, song or voice line30 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.

  • 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

See all: Docs · Site map

See the price first, then spend.

Start for $10 a month. Ziztu starts at $10 a month for 7,000 credits.

Video
Image
Audio
Writing
Effects
Learn
PricingLog in
Theme