ziztu
Make a video

Ziztu API quickstart

Ziztu has a REST API. In six steps you make an API key, plan a micro drama with the Director, ask for the price and make the first frames under a max_credits cap.

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

Before you start

You need a Ziztu account with credits and curl. Every call below goes to the base address and sends the key in a header. Paid calls need a spend cap, so nothing here can cost more than the cap you write.

Base address: https://getziztu.com/api/v1. The same steps work from any language, and an AI agent can do them through the MCP server.

Step 1: make an API key

  1. Open the Studio at getziztu.com/app and sign in. Open Settings, then API keys.
  2. Name the key (for example "Claude Code") and pick its scopes: read to look around, generate to plan and make things, export to download films.
  3. Copy the key. It starts with sk_sakuga_ and is shown once.

Read authentication for what each scope allows. Then set the key and the base address in your shell:

Set the key and the base address
export ZIZTU_TOKEN=sk_sakuga_your_key
BASE=https://getziztu.com/api/v1
AUTH="Authorization: Bearer $ZIZTU_TOKEN"
JSON='Content-Type: application/json'

Paste your own key where it says sk_sakuga_your_key. The next blocks use these four variables.

Step 2: check the key and the balance

Check your key and balance
curl -s https://getziztu.com/api/v1/credits -H "Authorization: Bearer $ZIZTU_TOKEN"

The reply shows your credits and plan. A wrong key returns invalid_api_key, and a key without a header returns unauthenticated. The full list is on the errors page.

Step 3: create a project and let the Director plan it

Create a project
curl -sX POST $BASE/projects -H "$AUTH" -H "$JSON" \
  -d '{"name":"Dough letter","aspect":"9:16"}'
PID=...   # the id in the reply

9:16 is a vertical drama. The reply has the project id.

Ask the Director to plan it, then apply the free actions
curl -sX POST $BASE/projects/$PID/director/chat -H "$AUTH" -H "$JSON" \
  -d '{"message":"Plan a 60 second micro drama about a baker who finds a love letter in the dough"}'
MID=...   # message.id in the reply

curl -sX POST $BASE/projects/$PID/director/messages/$MID/apply-all -H "$AUTH"

The reply lists the proposed actions: the cast, the places and each shot. Applying them is free.

The Director is the planning agent. It answers with the cast, the places and each shot as proposed actions, and apply-all applies the free ones, so the project now has its characters and shots. Director messages are metered by use and come off your credit balance.

Step 4: ask for the price

Price the first frames. Nothing is spent
curl -sX POST $BASE/projects/$PID/generate/frames -H "$AUTH" -H "$JSON" \
  -d '{"max_credits":9990,"dry_run":true}'

The reply is the quote: the exact credits, and any shot that is blocked and why.

dry_run: true returns the exact credits and starts nothing. The quote also lists any shot that is blocked, and why. Credits explains the caps in full.

Step 5: make the first frames

Make the first frames inside a cap
curl -sX POST $BASE/projects/$PID/generate/frames -H "$AUTH" -H "$JSON" \
  -H 'Idempotency-Key: frames-001' \
  -d '{"max_credits":2000}'
JID=...   # the job id in the reply

If the real price is above max_credits the call is refused and nothing starts.

max_credits is required. If the real price is higher the call is refused and nothing starts. Above 5,000 credits you must also send confirm: true. The Idempotency-Key makes a retry safe: the same key and body returns the first answer.

Step 6: follow the job and export

Follow the job, then export the film
curl -s $BASE/jobs/$JID -H "$AUTH"

curl -sX POST $BASE/projects/$PID/export -H "$AUTH"

Poll the job until it is done. Animating the shots works the same way with generate/animate.

Check the frames before you pay for motion. Then animate the shots with POST /projects/:pid/generate/animate and the same max_credits rule, and export. Rate limits are 120 requests a minute per key and 30 paid requests a minute.

Where to go next

  • Every endpoint and model id: the API reference.
  • The machine-readable spec for an API client: OpenAPI.
  • Let an agent do these steps: the agent guide.
  • What each result costs and how the caps work: credits.

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 I make my first Ziztu API call?

Make an API key in the Studio under Settings, API keys. Send it as a bearer token to GET /api/v1/credits to check it, then create a project, ask the Director to plan it, price the first frames with dry_run and make them with max_credits.

Can the quickstart spend more than I allow?

No. Every paid call needs max_credits and is refused if the real price is higher. Above 5,000 credits it also needs confirm: true. dry_run returns the price and starts nothing.

What does it cost to try the API?

A key spends the credits of the account that made it. Start for $10 a month. Ziztu starts at $10 a month for 7,000 credits.

Which language do I use?

Any. The API is plain HTTPS and JSON, so curl, Python, JavaScript or any HTTP client works. The OpenAPI spec lets a client generate the calls.

  • Ziztu authenticationZiztu has two ways in: an API key sent as a bearer token for scripts and servers, and an OAuth sign-in for MCP clients such as…
  • Ziztu credits and spend capsEverything 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…
  • Ziztu MCP serversZiztu has MCP servers for narrated YouTube videos (https://getziztu.com/mcp/youtube), short reels (https://getziztu.com/mcp/reel)…
  • Ziztu PlannerZiztu Planner brings the Script Writer and the Director into Claude and other MCP clients.
  • 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 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 Story ReelsAnimated story reels made with Claude: couples, family, comebacks and twists, with your product inside the story.
  • Ziztu changelogWhat changed in Ziztu, newest first, in plain words.

See all: Docs · Site map

Make the key and run step one.

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

Video
Image
Audio
Writing
Effects
Learn
PricingLog in
Theme