Seedream 4.0/4.5 Image API

Overview

Models: Seedream 4.0 (seedream-4) and Seedream 4.5 (seedream-4.5); 4.5 is higher quality, slightly slower.
Capabilities: text-to-image, multi-image fusion (up to 14 refs), batch output (up to 15 images).
Resolution: 1K / 2K / 4K (default 2K); aspect_ratio added for framing.
Pricing: 30 credits per Seedream 4.0 output or 40 per Seedream 4.5 output, independent of resolution; input references are not charged. Total input+output ≤ 15.
Submit: POST https://api.wizzx.ai/api/v1/task/submit/seedream-4 or /seedream-4.5; status via /api/v1/task/status.

Breaking Change (2025-12-10): size replaced by resolution; new aspect_ratio field. Update clients to avoid validation errors.

Auth

Authorization: Bearer <your_api_key>

Model comparison

Feature	Seedream 4.0	Seedream 4.5
Model ID	`seedream-4`	`seedream-4.5`
Quality	High	Higher
Speed	Faster	Slightly slower
Credits/output	30	40

Each output costs 30/40 credits respectively (1000 credits = $1). Resolution and input-reference count do not change the price; batch_size multiplies it by the number of outputs.

Submit job

Endpoint: POST https://api.wizzx.ai/api/v1/task/submit/seedream-4 or /seedream-4.5, Content-Type: application/json

Field	Type	Required	Default/Limit	Description
`prompt`	string	Yes	-	Text prompt
`image_urls`	`array<string>`	No	Max 14	Fusion refs (JPEG/PNG/WebP)
`aspect_ratio`	string	No	-	Ratios: `1:1`, `4:3`, `3:4`, `16:9`, `9:16`, `3:2`, `2:3`, `21:9`
`resolution`	string	No	`2K`	`1K` / `2K` / `4K`
`batch_size`	int	No	1	Output count 1-15; input+output ≤15
`seed`	int	No	-1	-1 random, range [-1, 2147483647]
`watermark`	bool	No	false	Add watermark

Aspect ratios appended to prompt (e.g., 16:9 - 2560x1440).
Constraint: input images + batch_size <= 15; else validation fails.

Example (text-to-image, Seedream 4.0)

curl -X POST https://api.wizzx.ai/api/v1/task/submit/seedream-4 \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A futuristic city at night with neon lights",
    "aspect_ratio": "16:9",
    "resolution": "2K"
  }'

Example (high quality, Seedream 4.5)

curl -X POST https://api.wizzx.ai/api/v1/task/submit/seedream-4.5 \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene mountain landscape",
    "aspect_ratio": "21:9",
    "resolution": "4K"
  }'

Example (multi-image fusion)

curl -X POST https://api.wizzx.ai/api/v1/task/submit/seedream-4.5 \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Merge these images into a cohesive scene",
    "image_urls": [
      "https://example.com/image1.jpg",
      "https://example.com/image2.jpg",
      "https://example.com/image3.jpg"
    ],
    "aspect_ratio": "16:9",
    "resolution": "2K"
  }'

Example (batch generation)

curl -X POST https://api.wizzx.ai/api/v1/task/submit/seedream-4 \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cute cat in different poses",
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "batch_size": 4
  }'

Success response

{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "4bbbc9e0-8de8-4f35-a31e-8596c1a6d18a",
    "model_key": "seedream-4",
    "credits_deducted": 120
  },
  "request_id": "d54c66a8-0f0f-439c-bd3a-36f3fd275881"
}

Query status

Endpoint: POST https://api.wizzx.ai/api/v1/task/status

{
  "task_id": "4bbbc9e0-8de8-4f35-a31e-8596c1a6d18a"
}

Client-visible states: PENDING, QUEUED, PROCESSING, REVIEW_REQUIRED, SUCCEEDED, and FAILED. See the task status API reference.

Migration (size → resolution + aspect_ratio)

Old (deprecated):

{
  "prompt": "...",
  "size": "2K"
}

New:

{
  "prompt": "...",
  "resolution": "2K",
  "aspect_ratio": "16:9"
}

Best practices

Resolution: iterate with 1K/2K, finalize with 4K.
Aspect ratio: 1:1 social/cover, 16:9 landscape, 9:16 portrait, 21:9 cinematic.
Batch: use batch_size for variations; ensure input + output ≤ 15.
Fusion: keep 1-3 core refs for clearer guidance; input references do not add credits.
Seeds: fixed seed to reproduce; -1/random for variety.
Watermark: off by default; enable for compliance when needed.

Getting started

Agent integrations

Video Generation

Image Generation

Seedream 4.0/4.5 Image API

Overview

Auth

Model comparison

Submit job

Example (text-to-image, Seedream 4.0)

Example (high quality, Seedream 4.5)

Example (multi-image fusion)

Example (batch generation)

Success response

Query status

Migration (size → resolution + aspect_ratio)

Best practices

​Overview

​Auth

​Model comparison

​Submit job

​Example (text-to-image, Seedream 4.0)

​Example (high quality, Seedream 4.5)

​Example (multi-image fusion)

​Example (batch generation)

​Success response

​Query status

​Migration (size → resolution + aspect_ratio)

​Best practices

Overview

Auth

Model comparison

Submit job

Example (text-to-image, Seedream 4.0)

Example (high quality, Seedream 4.5)

Example (multi-image fusion)

Example (batch generation)

Success response

Query status

Migration (size → resolution + aspect_ratio)

Best practices