Seedream Series

POST

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>"
}
'

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>",
    "image_urls": ["<string>"],
    "callback_url": "<string>"
}
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>',
    image_urls: ['<string>'],
    callback_url: '<string>'
  })
};

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  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"callback_url\": \"<string>\"\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  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"callback_url\": \"<string>\"\n}")
  .asString();

{
  "task_id": "task-wave1775285160b950328499",
  "model": "doubao-seedream-4.5",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

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

Model	Price (per image)
`doubao-seedream-5.0-lite`	`$0.02975`
`doubao-seedream-4.5`	`$0.02975`
`doubao-seedream-4.0`	`$0.0238`

Mode Quick Reference

Mode	Trigger Field	Supported Versions
Text-to-image	`prompt` only	All
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"
  }'

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-4.5",
    "prompt": "Place the character from the first image into the scene from the second image",
    "image_urls": [
      "https://cdn.example.com/character.jpg",
      "https://cdn.example.com/scene.jpg"
    ],
    "resolution": "4K",
    "aspect_ratio": "16:9"
  }'

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-4.0",
    "action": "edit",
    "prompt": "Replace the background with a sunset sky, keep the subject unchanged",
    "image_urls": ["https://cdn.example.com/portrait.jpg"],
    "resolution": "2K"
  }'

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-4.5",
    "prompt": "Four e-commerce hero images: front / side / detail / lifestyle",
    "sequential_image_generation": "auto",
    "sequential_image_generation_options": {"max_images": 4},
    "resolution": "4K",
    "aspect_ratio": "1:1"
  }'

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

Common Parameters

string

required

Choose one from the Available Models list

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)

string

required

Image description. Supports Chinese and English. Seedream achieves ~94% accuracy on complex typography and small text rendering

integer

default:"1"

Number of images to generate (returned in a single call)

integer

default:"-1"

Random seed. -1 for random; a fixed value reproduces similar results

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)

string

default:"2K"

Output resolution, depends on the model:

4.0: 1K / 2K / 4K
4.5: 2K / 4K
5.0-lite: 2K / 3K

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

string

Webhook callback URL, invoked when the task reaches a terminal state. See Callback Mechanism

Model-Specific Parameters

Seedream 5.0 Lite
Seedream 4.5
Seedream 4.0

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)

boolean

default:"false"

AI-generated watermark

string

default:"jpeg"

5.0-lite only — Output format. Options:

jpeg
png

string

default:"disabled"

Image group generation mode. Options:

disabled — Single image (default)
auto — Auto group (multiple themed images)

object

Group options, e.g. {"max_images": 4} (range 1-15)

Supported actions: generate / image2image / edit / reference / groupresolution: 2K / 4KKey features: Native 4K, 14 reference images, ~90% cross-angle character consistency, ~94% typography and dense-text rendering accuracy

boolean

default:"false"

AI-generated watermark

object

Prompt optimization (nested object) with a mode field. Example: {"mode": "standard"}

string

default:"disabled"

Group mode. Options:

disabled — Single image
auto — Auto group

object

Group options, e.g. {"max_images": 4} (range 1-15)

Supported actions: generate / image2image / edit / reference / groupresolution: 1K / 2K / 4KKey features: Origin of multimodal creation; unified interface for text-to-image / editing / image groups; 2-10 reference images, combined with final output ≤15

boolean

default:"false"

AI-generated watermark

string

default:"standard"

Prompt optimization (string, unlike 4.5’s nested object). Options:

standard — Standard optimization (default)
fast — Fast mode

string

default:"disabled"

Group mode. Options:

disabled — Single image
auto — Auto group

object

Group options, e.g. {"max_images": 4} (range 1-15)

Resource Limits

Item	Limit
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 resolution	See each tab (up to 4K)
Output file	JPG (default) / PNG (5.0-lite optional), URL valid for 24 hours

Task System — Task state machine / polling cadence / async push
Request & Response — Common error codes / Headers / rate limits
Authentication — API Key application and usage

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>"
}
'

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>",
    "image_urls": ["<string>"],
    "callback_url": "<string>"
}
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>',
    image_urls: ['<string>'],
    callback_url: '<string>'
  })
};

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  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"callback_url\": \"<string>\"\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  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"callback_url\": \"<string>\"\n}")
  .asString();

{
  "task_id": "task-wave1775285160b950328499",
  "model": "doubao-seedream-4.5",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

Text Generation

Image Generation

Video Generation

Audio

Tools & Embeddings

Task Management

Pricing

Mode Quick Reference

Examples

Available Models

Common Parameters

Model-Specific Parameters

Resource Limits

​Pricing

​Mode Quick Reference

​Examples

​Available Models

​Common Parameters

​Model-Specific Parameters

​Resource Limits

​Related Docs

Pricing

Mode Quick Reference

Examples

Available Models

Common Parameters

Model-Specific Parameters

Resource Limits

Related Docs