Skip to main content
POST
/
v1
/
tasks
Seedream Series
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>",
  "image_urls": [
    "<string>"
  ],
  "callback_url": "<string>"
}
'
{
  "task_id": "task-wave1775285160b950328499",
  "model": "doubao-seedream-4.5",
  "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.

ByteDance Seed team’s image generation series, with three generations:
  • 5.0 Lite — Visual reasoning (CoT) + real-time web search, 14 reference images, 2K/3K, strong identity preservation, cost-effective tier
  • 4.5 — Professional production grade, native 4K, 14 reference images, 94% typography accuracy, 90% cross-angle character consistency
  • 4.0 — Multimodal creation, 2-10 reference image fusion, unified interface for text-to-image / editing / image groups
Per-image pricing, generates 1K-4K images (range varies by version).

​
Pricing

ModelPrice (per image)
doubao-seedream-5.0-lite$0.02975
doubao-seedream-4.5$0.02975
doubao-seedream-4.0$0.0238

​
Mode Quick Reference

ModeTrigger FieldSupported Versions
Text-to-imageprompt onlyAll
Image edit (inpainting / lighting changes)+ image_urls (single) + action: "edit"4.0 / 4.5
Multi-image reference fusion+ image_urls (multiple)All (4.0=2-10 / 4.5=14 / 5.0-lite=14)
Image group generation (themed set)sequential_image_generation: "auto"All

​
Examples

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5.0-lite",
    "prompt": "Futuristic city night view, neon lights reflected on wet streets, cinematic composition",
    "resolution": "2K",
    "aspect_ratio": "16:9"
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "doubao-seedream-4.5",
  "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
doubao-seedream-5.0-liteVisual reasoning + web search, 14 reference images, 2K/3K, strong identity preservation
doubao-seedream-4.5Professional production grade, 4K, 14 reference images, best typography / character consistency
doubao-seedream-4.0Multimodal creation, 2-10 reference images, unified interface for text-to-image / editing / image groups

​
Common Parameters

​
model
string
required
Choose one from the Available Models list
​
action
string
default:"generate"
Operation type. Options:
  • generate — Text-to-image (default)
  • image2image — Image-to-image (use with image_urls)
  • edit — Image editing (inpainting / lighting changes, 4.0 / 4.5 only)
  • reference — Multi-image reference fusion (4.0 / 4.5 only)
  • group — Image group generation (all versions)
​
prompt
string
required
Image description. Supports Chinese and English. Seedream achieves ~94% accuracy on complex typography and small text rendering
​
n
integer
default:"1"
Number of images to generate (returned in a single call)
​
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
  • 21:9 — Ultra-wide (all versions)
  • 9:21 — Ultra-tall (4.0 / 4.5 only)
  • auto — Smart selection (follows reference image ratio)
​
resolution
string
default:"2K"
Output resolution, depends on the model:
  • 4.0: 1K / 2K / 4K
  • 4.5: 2K / 4K
  • 5.0-lite: 2K / 3K
​
image_urls
string[]
Array of reference image URLs. Count depends on the model:
  • 4.0: 2-10 images (combined with final output ≤15)
  • 4.5: up to 14
  • 5.0-lite: up to 14
​
callback_url
string
Webhook callback URL, invoked when the task reaches a terminal state. See Callback Mechanism

​
Model-Specific Parameters

Supported actions: generate / image2image / group (note: does not support edit or reference)resolution: 2K / 3KKey features: Visual reasoning (CoT) + real-time web search, can reason from up-to-date world knowledge; strong identity preservation (eyes / jawline / proportions / skin tone preserved across styles)
​
watermark
boolean
default:"false"
AI-generated watermark
​
output_format
string
default:"jpeg"
5.0-lite only — Output format. Options:
  • jpeg
  • png
​
sequential_image_generation
string
default:"disabled"
Image group generation mode. Options:
  • disabled — Single image (default)
  • auto — Auto group (multiple themed images)
​
sequential_image_generation_options
object
Group options, e.g. {"max_images": 4} (range 1-15)

​
Resource Limits

ItemLimit
Reference images (4.0)2-10, combined with final output ≤15
Reference images (4.5 / 5.0-lite)Up to 14
Single image size≤ 30MB, supports JPG/PNG/WEBP
Output resolutionSee each tab (up to 4K)
Output fileJPG (default) / PNG (5.0-lite optional), URL valid for 24 hours