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".
| Field | Type & Default | Constraints & Description |
|---|---|---|
AuthorizationRequiredHeader | string | Bearer cm_live_... server-side API key from your account. |
Idempotency-KeyOptionalHeader | stringDefault: recommended | 1 to 255 ASCII chars. Prevents duplicate submissions and charges for 24h. |
modelRequired | "seedream-5.5" | Public model ID mapped to BytePlus Seedream 5.5. |
promptRequired | string | Non-empty UTF-8 description of desired image or edit. |
qualityOptional | "1K" | "1.5K" | "2K"Default: "1K" | Output resolution tier (1K / 1.5K = 1.88 Credits; 2K = 3.29 Credits). |
sizeOptional | "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_formatOptional | "png" | "jpeg"Default: "png" | Output encoding ("png" required when background is "transparent"). |
backgroundOptional | "opaque" | "transparent" | "auto"Default: "opaque" | Alpha channel mode for cutouts and stickers. |
image_urlsOptional | 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.
| Specification | Callmodels Credits | USD 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 |