Skip to main content
POST
/
v1
/
tasks
Z.ai Image
curl --request POST \
  --url https://www.qingbo.dev/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "n": 123,
  "seed": 123,
  "aspect_ratio": "<string>",
  "resolution": "<string>",
  "callback_url": "<string>",
  "callback_events": [
    "<string>"
  ],
  "prompt_extend": true
}
'
{
  "task_id": "task-wave1775285160b950328499",
  "model": "z-image-turbo",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

Documentation Index

Fetch the complete documentation index at: https://docs.qingbo.dev/llms.txt

Use this file to discover all available pages before exploring further.

Lightweight and fast image generation from Zhipu Z.ai, with strong support for both Chinese and English prompts. Low latency, low price — suited for high-frequency scenarios like batch sketches, operations creatives, and quick previews. Per-image pricing. Pure text-to-image (no reference images), fixed at 1 image per call.

​
Pricing

ModelPrice (per image)
z-image-turbo$0.010625

​
Examples

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "z-image-turbo",
    "prompt": "Seaside cafe at sunset, wooden deck, warm tones",
    "aspect_ratio": "16:9",
    "resolution": "1K"
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "z-image-turbo",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}
After submission, poll status with GET /v1/tasks/{task_id}. See Task System for details.

​
Available Models

Model IDDescription
z-image-turboLightweight and fast, bilingual, 1K/2K, pure text-to-image (no reference images)

​
Common Parameters

​
model
string
required
Choose one from the Available Models list
​
action
string
default:"generate"
Operation type. z-image-turbo only supports generate (text-to-image)
​
prompt
string
required
Image description. Strong support for both Chinese and English. Max 800 characters
​
n
integer
default:"1"
Number of images. This model is fixed at 1 image per call; n > 1 is not supported
​
seed
integer
default:"-1"
Random seed. -1 for random; a fixed value reproduces similar results
​
aspect_ratio
string
default:"1:1"
Aspect ratio. Options:
  • 1:1 — Square
  • 4:3 / 3:4 — Standard landscape / portrait
  • 16:9 / 9:16 — Widescreen landscape / portrait
  • 3:2 / 2:3 — Camera ratio landscape / portrait
​
resolution
string
default:"1K"
Output resolution. Options: 1K / 2K
​
callback_url
string
Webhook callback URL, invoked when the task reaches a terminal state. See Callback Mechanism
​
callback_events
string[]
Events to receive callbacks for. Defaults to terminal events only. See Callback Mechanism

​
Model-Specific Parameters

​
prompt_extend
boolean
default:"false"
Smart prompt rewrite. When enabled, AI auto-optimizes the prompt for better results, but adds extra cost

​
Notes

  • Single image per call — n is fixed at 1; submit multiple tasks for multiple images
  • Prompt limit 800 characters — trim long prompts yourself
  • Enabling prompt_extend increases cost — AI rewrite consumes extra inference cost; enable selectively for batch scenarios
  • Pure text-to-image — does not accept image_urls reference images; use other models for image-to-image

​
Resource Limits

ItemLimit
Images per callFixed at 1
Prompt length≤ 800 characters
Output resolution1K / 2K
Output fileJPG, URL valid for 24 hours