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 | Endpoint | Description |
|---|---|---|
| Text to image | POST /api/v1/generate | Base generation from a text prompt. |
| Poll task | GET /api/v1/task/{id}?model=z-image | Retrieve state and result URLs. |
Input parameters
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | textarea | required | Must be between 3 and 1000 characters. |
| aspect_ratio | select | required | 1:1, 4:3, 3:4, 16:9, 9:16 |
| nsfw_checker | select | optional | false, 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 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":"1:1","nsfw_checker":"true"}}'