Seedream 5.5 API Docs

BytePlus Seedream 5.5 image generation and editing across 1K, 1.5K, and 2K outputs with transparent PNG support and fixed per-image pricing.

POST /v1/images/generations · seedream-5.5

Request schema

seedream-5.5 uses fixed per-image pricing controlled solely by quality ("1K" | "1.5K" | "2K") and optional image_urls (1..10). When background is "transparent", output_format must be "png".

FieldType & DefaultConstraints & Description
Authorization
RequiredHeader
string
Bearer cm_live_... server-side API key from your account.
Idempotency-Key
OptionalHeader
stringDefault: recommended
1 to 255 ASCII chars. Prevents duplicate submissions and charges for 24h.
model
Required
"seedream-5.5"
Public model ID mapped to BytePlus Seedream 5.5.
prompt
Required
string
Non-empty UTF-8 description of desired image or edit.
quality
Optional
"1K" | "1.5K" | "2K"Default: "1K"
Output resolution tier (1K / 1.5K = 1.88 Credits; 2K = 3.29 Credits).
size
Optional
"auto" | "1:1" | "16:9" | "9:16" | ...Default: "1:1"
Supports "auto", 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 4:5, 5:4, 21:9, 9:21.
output_format
Optional
"png" | "jpeg"Default: "png"
Output encoding ("png" required when background is "transparent").
background
Optional
"opaque" | "transparent" | "auto"Default: "opaque"
Alpha channel mode for cutouts and stickers.
image_urls
Optional
string[] (1..10)Default: omitted
Optional 1–10 HTTPS reference images (+0.752 Credits each).

Transparent PNG & multi-image edit examples

Use background: "transparent" with output_format: "png" for e-commerce cutouts, stickers, and UI assets.

curl -sS -X POST "https://api.callmodels.dev/v1/images/generations" \
  -H "Authorization: Bearer $CALLMODELS_API_KEY" \
  -H "Idempotency-Key: img_req_20261115_01" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5.5",
  "prompt": "Botanical white orchid stem with crystal water droplets, isolated clean edges",
  "size": "1:1",
  "quality": "1.5K",
  "output_format": "png",
  "background": "transparent"
}'

Task response payloads

A completed 1K or 1.5K text-to-image call always settles at "1.88" Credits ("2.632" with 1 reference image).

{
  "id": "task_01e561ba-859e-47fe-be79-60bc6f1d6499",
  "model": "seedream-5.5",
  "object": "image.generation.task",
  "status": "pending",
  "created_at": "2026-11-15T09:49:18.000Z"
}

Fixed per-image pricing table

Aspect ratio (1:1, 16:9, 9:16, auto, etc.) and prompt length never change the per-image price.

SpecificationCallmodels CreditsUSD Equiv.Official Ref.
1K or 1.5K output · Text-to-image (0 ref images)1.880000 Credits$0.0188$0.020
2K output · Text-to-image (0 ref images)3.290000 Credits$0.0329$0.035
Reference image surcharge (each image in image_urls, 1–10)+0.752000 Credits / ref+$0.00752+$0.008