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
}
'
import requests

url = "https://www.qingbo.dev/v1/tasks"

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "n": 123,
    "seed": 123,
    "aspect_ratio": "<string>",
    "resolution": "<string>",
    "callback_url": "<string>",
    "callback_events": ["<string>"],
    "prompt_extend": True
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    action: '<string>',
    prompt: '<string>',
    n: 123,
    seed: 123,
    aspect_ratio: '<string>',
    resolution: '<string>',
    callback_url: '<string>',
    callback_events: ['<string>'],
    prompt_extend: true
  })
};

fetch('https://www.qingbo.dev/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.qingbo.dev/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"n\": 123,\n  \"seed\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"callback_events\": [\n    \"<string>\"\n  ],\n  \"prompt_extend\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://www.qingbo.dev/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"n\": 123,\n  \"seed\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"callback_events\": [\n    \"<string>\"\n  ],\n  \"prompt_extend\": true\n}")
  .asString();
{
  "task_id": "task-wave1775285160b950328499",
  "model": "z-image-turbo",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}
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"
  }'

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": "A Shiba Inu",
    "prompt_extend": true,
    "aspect_ratio": "1:1",
    "resolution": "2K"
  }'

{
  "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