Z Image Turbo
Live on the APIz-image-turbo$0.00507/image$0.015-66%
- Input → output
- Text promptImage
Z Image Turbo API prices
Every tier we sell, next to the model maker's official price.
| Tier | Opennan | Official |
|---|---|---|
| Any size | $0.00507 | $0.01566% below |
Official is the model maker's own list price for the same tier. Where the maker publishes a price, we never sell above it, most tiers at least 10% below.
Call Z Image Turbo from your code
Everything for your first call is on this page: the endpoint, a key, the request and every parameter.
https:/Get an API key
Create a key in the console. It uses the same balance as the playground.
Create a keySend your first request
The same request the playground sends. Set OPENNAN_KEY to your key.
curl https://api.opennan.com/v1/images/generations \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"z-image-turbo","prompt":"A glass teapot on a sunlit windowsill, soft morning light, 35mm photo","aspect_ratio":"1:1"}' # Then poll until "status" is "succeeded" or "failed": curl https://api.opennan.com/v1/tasks/<task id> -H "Authorization: Bearer $OPENNAN_KEY"Poll the task
The call answers right away with a task id. Ask for the task until it finishes:
GEThttps:// api.opennan.com/ v1/ tasks/ {id} - queued
- Waiting for a worker
- running
- Being made
- succeeded
- Done: outputs[].url holds the files
- failed
- Failed: you are not charged
Parameters
Built from the live catalog: every value listed here is one the API accepts.
Errors and how to fix them
401Missing or wrong key
Send the header Authorization: Bearer with a key from the console.
402Balance too low
Add credit in Billing, then send the same call again.
400A value is not accepted
Read error.message: it names the field. Use a value from the parameter table.
429Too many requests
Wait a few seconds and try again, waiting longer after each 429.
Add Opennan to your AI app
One install gives your AI every Opennan tool: video, images, chat, voice, music, sound effects, 3D, captions and dubbing. Pick your app and follow the steps.
https:/Works in the Codex CLI, the Codex app and the Codex IDE extension: they share ~/.codex/config.toml. If the app or IDE does not see OPENNAN_KEY, use the config.toml option with your key in it. Codex asks before each tool call: approve it to go on.
Get an API key
Create a key in the console. It starts with sk- and uses the same balance as the website.
Create a keySave your key as OPENNAN_KEY
# macOS / Linux (zsh shown; bash: ~/.bashrc) echo 'export OPENNAN_KEY="sk-..."' >> ~/.zshrc source ~/.zshrc # Windows (PowerShell), then open a new terminal setx OPENNAN_KEY "sk-..."Install the Opennan plugin: the server plus a skill that teaches your AI to pick models, confirm prices and wait for results
codex plugin marketplace add Opennan/opennan-ai-plugin codex plugin add opennan@opennanOr add only the server
codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEYOr add this to ~/.codex/config.toml
[mcp_servers.opennan] url = "https://api.opennan.com/v1/mcp" http_headers = { Authorization = "Bearer sk-..." }Check that opennan is listed
codex mcp listRestart Codex, then ask for anything
“Make a 5 second video of rain on a neon street, a song to go with it and a poster image.”
Replace sk-... with your own key and keep it private: anyone who has it can spend your balance. Your app can list the tools before you add a key; making anything needs one.
This tool from your AI
Once Opennan is added, your AI calls this tool with arguments like these.
- Tool
- generate_image
- Example arguments
{ "model": "z-image-turbo", "prompt": "A glass teapot on a sunlit windowsill, soft morning light, 35mm photo" }
Z Image Turbo API questions
How much does the Z Image Turbo API cost?
Z Image Turbo API on Opennan: $0.00507 per image, 66% below Alibaba's official $0.015 per image. Prices are in US dollars per call, shown before you run, and every tier is in the price table.
How does that compare with the official price?
Alibaba lists $0.015 per image; Opennan charges $0.00507 per image, 66% below. We only sell a tier below the maker's official price, most tiers at least 10% below.
What inputs does Z Image Turbo take?
Text prompt.
Which options can a call set?
Aspect ratios: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9.
How is it billed?
Per image, by quality and size.
What happens if a generation fails?
A failed task is refunded in full. You pay only for results.
How do I call Z Image Turbo from an AI agent?
Add the MCP server https://api.opennan.com/v1/mcp with your API key as a bearer token, then call the generate_image tool with model "z-image-turbo". Or send a POST to https://api.opennan.com/v1/images/generations.
Similar models
Image models you can call with the same key.
