Image models
Z-Image
On this page
Z-Image — fast, high-fidelity AI image generation & editing.
| modelId | z-image |
| Modality | image |
| Pricing | See this model on the Pricing page for the current per-call price (with your markup). |
Operations
| Operation | modelId | Endpoint | Required input |
|---|---|---|---|
| Default | z-image | POST /api/v1/generate | prompt, aspect_ratio |
| Poll task | — | GET /api/v1/task/{id}?model=z-image | — |
Input parameters
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | A text description of the image you want to generate Max 1000 characters. (default: A weathered brass compass resting on an unfurled antique nautical map, warm candlelight catching its engraved edges and glass face, shallow depth of field, cinematic still-life mood.) |
| aspect_ratio | string | Yes | Aspect ratio for the generated image. Select 'auto' to match the first input image ratio (requires input image). (options: 1:1 | 4:3 | 3:4 | 16:9 | 9:16) (default: 1:1) |
| nsfw_checker | boolean | No | A configurable parameter. Defaults to true in the Playground. (true/false) (default: true) |
Example request
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"z-image","input":{"prompt":"A photorealistic portrait of a red fox in a snowy forest, soft morning light, shallow depth of field, 85mm.","aspect_ratio":"1:1","nsfw_checker":true}}'