Ziztu OpenAPI spec
The Ziztu API is described as one OpenAPI 3.1 document at https://getziztu.com/openapi.json. Import it into an API client to get every endpoint, its request body and the security schemes.
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
The address
https://getziztu.com/openapi.json
JSON, OpenAPI 3.1. It needs no key to read.
curl -s https://getziztu.com/openapi.json
The document has 60 operations on 49 paths: the REST API endpoints. It is written from the same list as the API page, and a test checks the document against that page and against the route handlers, so they do not drift apart.
What is in it
The groups, as on the API page:
- Projects
- Characters and places
- Shots
- Music tracks
- Director AI
- AI Script Writer
- Paid generation
- Export and media
- Jobs
- Credits
- Tools
- API keys
Each operation has its method, path, the scopes it needs, its request body and the HTTP statuses it can return. Paths start with /api/v1, and the servers entry is https://getziztu.com.
Security in the spec
Two schemes describe the API key: a bearer token in the Authorization header, and the same key in the X-API-Key header. Use either one. The spec also describes the OAuth sign-in with its scopes, and the signed-in session used by the API key routes. See authentication for how to make a key and what each scope allows.
Import it
Any client that reads OpenAPI 3.1 can import the document from its address. In a client such as Postman, choose Import and paste the address above. Generators for typed SDKs read it the same way.
Spend rules still apply to a client built from the spec: a paid call needs max_credits, and dry_run returns the price first. Start with the quickstart.
The older spec
A shorter document is also served at https://getziztu.com/api/v1/openapi.json. It is kept for clients that already use it. New clients should use https://getziztu.com/openapi.json.
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
Does Ziztu have an OpenAPI spec?
Ziztu has an OpenAPI 3.1 spec of its public API at https://getziztu.com/openapi.json. It needs no key to read, and any client that reads OpenAPI can import it.
How do I import the Ziztu API into Postman?
Choose Import in Postman and paste https://getziztu.com/openapi.json. Postman reads the endpoints, the request bodies and the security schemes.
Which authentication does the spec describe?
A bearer token in the Authorization header and the same API key in the X-API-Key header. Use either one.
Is the older spec still available?
Yes. https://getziztu.com/api/v1/openapi.json still answers, for clients that already use it.
More docs
- Use Ziztu from an AI agentTo make a micro drama from Claude Code, add the Ziztu MCP server with one command, ask the Director to plan your idea, then make…
- 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 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 MCP serversZiztu has MCP servers for narrated YouTube videos (https://getziztu.com/mcp/youtube), short reels (https://getziztu.com/mcp/reel)…
- Ziztu Reel StudioZiztu Reel Studio is an MCP server at https://getziztu.com/mcp/reel.
- 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
- Chrome extension privacy policyWhat the Ziztu Chrome extension collects (nothing) and the one permission it asks for.
- Ziztu changelog, 11 October 2026A script editor, shared projects and 11 interface languages.
Import the spec and make a first call.
Start for $10 a month. Ziztu starts at $10 a month for 7,000 credits.