ziztu
Make a video

Ziztu authentication

Ziztu 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 Claude, Codex and Cursor.

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

API keys

An API key acts as your account and spends its credits. Make one in the Studio:

  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.

Send the key on every request, in either header:

Headers
Authorization: Bearer sk_sakuga_your_key
X-API-Key: sk_sakuga_your_key

Use one of the two.

You can have up to 20 active keys. Keys are made and revoked with a signed-in session in the Studio. A key cannot make other keys.

Scopes

A key holds one or more scopes. A call without the scope it needs is refused with insufficient_scope.

ScopeWhat it allows
readEvery GET: projects, characters, shots, jobs and the credit balance.
generateEvery change, including paid generation. Every paid call still needs max_credits.
exportRenders and downloads of finished films.
planOnly on the planner edition: create projects, talk to the Director and write scripts. It never allows generation or export.

To let an agent look but not spend, give its key read only.

OAuth sign-in for the MCP server

The hosted MCP server at https://getziztu.com/mcp signs you in with your Ziztu account, so there is no key to copy. The client opens a sign-in page on getziztu.com, you tick what the app may do, and it can never do more than you ticked.

  • The server uses the authorization code flow with PKCE (S256) and refresh tokens, and clients can register themselves.
  • The sign-in lasts an hour and renews itself while you use the app. A refresh token keeps the connection for 30 days after the last use.
  • The server publishes its metadata at /.well-known/oauth-authorization-server and /.well-known/oauth-protected-resource, so a client can find the endpoints by itself.
  • You can disconnect any app on the connected apps page, getziztu.com/oauth/connections, and it stops at once.

A client that cannot open a browser can send an API key as a bearer token to the same address instead. Both ways follow the same spend rules. The install lines for each client are on the MCP server page.

Keep a key safe

  • A key is shown once, when you make it. Copy it into an environment variable or a secret store, not into a file in a repository.
  • Make one key per tool or agent and name it, so you can revoke one without breaking the others.
  • Use read for anything that only looks. Add generate only where spending is intended.
  • Revoke a key under Settings, API keys. It stops working at once.

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 authenticate to the Ziztu API?

Send an API key as a bearer token in the Authorization header, or in the X-API-Key header. Make the key in the Studio under Settings, API keys.

What scopes does a Ziztu API key have?

read for every GET, generate for every change including paid generation, and export for renders and downloads. A key can hold any of them.

Does the Ziztu MCP server use OAuth?

Yes. The hosted server signs you in with your Ziztu account using the authorization code flow with PKCE. An API key as a bearer token also works for servers and scripts.

How do I revoke an API key?

Open Settings, then API keys in the Studio and revoke it. It stops working at once.

How many API keys can I have?

Up to 20 active keys per account.

  • 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 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 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 a key with the scopes you need.

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

Video
Image
Audio
Writing
Effects
Learn
PricingLog in
Theme