Get API Key Get API
Docs

Z-Image-Turbo Image Generation

- Asynchronous processing mode, returns task ID for subsequent queries

  • Lightweight and fast image generation, supports Chinese and English
  • Supports 1K/2K resolution tiers, supports smart prompt rewriting

Request example

curl --request POST \
  --url https://api.openveer.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "z-image-turbo",
    "prompt": "Ink painting style landscape scenery"
  }'

Response example

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01JGXYZ1234567890ABCDEF"
    }
  ]
}

Supported Models

Model Description Images Per Request Pricing
z-image-turbo Lightweight and fast image generation, supports Chinese and English Fixed 1 image Fixed price

Authorizations

Authorization string

All endpoints require Bearer Token authentication

Get API Key:

Visit API Key Management to get your API Key

Add to request header:

Authorization: Bearer YOUR_API_KEY

Body

model string

Model name

  • z-image-turbo - Lightweight and fast image generation, supports Chinese and English
nsfw_check boolean

Whether to run content moderation before submitting the image task.

  • true: use omni-moderation-latest to review prompts and input images
  • false or omitted: do not send a moderation request, adding no moderation cost or latency (default)
prompt string

Text description for image generation, up to 800 characters

size string

Image aspect ratio

Supported aspect ratios:

  • 1:1 - Square (default)
  • 4:3 - Landscape 4:3
  • 3:4 - Portrait 3:4
  • 16:9 - Landscape widescreen
  • 9:16 - Portrait vertical
  • 3:2 - Landscape 3:2
  • 2:3 - Portrait 2:3
resolution string

Resolution tier

  • 1K - Standard resolution (default)
  • 2K - High definition resolution
prompt_extend boolean

Smart prompt rewriting

When enabled, AI will automatically optimize the prompt for better results, and costs will increase.

  • false - Disabled (default)
  • true - Enabled

Resolution Reference Table

Output size is controlled by the combination of size (ratio) + resolution (resolution tier).

Ratio 1K Tier 2K Tier
1:1 1024×1024 2048×2048
4:3 1152×864 2048×1536
3:4 864×1152 1536×2048
16:9 1280×720 2048×1152
9:16 720×1280 1152×2048
3:2 1248×832 2048×1360
2:3 832×1248 1360×2048

Usage Examples

Basic Text-to-Image (minimal request)

{
  "model": "z-image-turbo",
  "prompt": "Ink painting style landscape scenery"
}

Specify ratio and resolution

{
  "model": "z-image-turbo",
  "prompt": "Minimalist style cafe interior design",
  "size": "16:9",
  "resolution": "2K"
}

Enable smart prompt rewriting

{
  "model": "z-image-turbo",
  "prompt": "A cat",
  "prompt_extend": true
}

Response

code integer

Response status code

data array
Response data array
status string

Task status

  * submitted - Submitted
task_id string

Task unique identifier

Notes

  1. Asynchronous Processing: After submission, a task_id is returned. Poll /v1/tasks/{task_id} to get results
  2. Image Storage: Generated images are mirrored to platform CDN and are valid long-term
  3. Billing Rules: Billed per successfully generated image, no charge for failures
  4. Fixed Count: Z-Image-Turbo generates exactly 1 image per request, n parameter is not supported

This documentation is built and hosted on Mintlify, a developer documentation platform.