Skip to Content
DocumentationModelsImageSeedream 5.5

Seedream 5.5

Use seedream-5-5 to create image output. This page contains the complete request needed for this model.

Model facts

PropertyValue
Model IDseedream-5-5
EndpointPOST /api/v1/generation/create
OutputImage
Modestext-to-image, image-to-image
PricingView current pricing 

Minimal request

curl -X POST https://api.api-stock.com/api/v1/generation/create \ -H "Authorization: Bearer $API_STOCK_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "seedream-5-5", "input": { "prompt": "A cinematic scene with soft natural light" } }'

The create response contains a task ID:

{ "code": 200, "data": { "taskId": "019ca881-9503-7270-a560-f00fc2b15785", "status": "not_started", "createdAt": "2026-08-22T12:00:00.000Z" } }

Parameters

Parameters belong inside the top-level input object. Unknown fields are rejected.

ParameterTypeRequiredDefaultDescription
promptstringYes—Text description for image generation or editing
urlsstring[]No—Up to 10 public HTTP(S) image URLs or lowercase base64 data:image URIs. JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC and HEIF; each at most 30 MiB and 36 million pixels. Every reference is billed, including the first.
sizestringNo"1:1"Aspect ratio or auto (model chooses the ratio), with resolution defaulting to 1K. Also accepts 1K / 1.5K / 2K or WIDTHxHEIGHT without resolution. Exact dimensions require 921600–4624220 pixels and ratio 1/16–16. Omission defaults to 1:1 at 1K.
resolution“1K” | “1.5K” | “2K”No"1K"Resolution for aspect-ratio or auto size (default 1K). Omit for tier or exact-pixel size.
background“auto” | “transparent” | “opaque”No"auto"Background mode. Transparent output requires PNG.
outputFormat“jpeg” | “png”No"png"Output format; JPEG cannot be combined with transparent background
promptOptimizeMode“standard”No"standard"Only standard is supported. Optimization remains enabled when omitted.

Modes

Minimal generation

{ "model": "seedream-5-5", "input": { "prompt": "A cinematic scene with soft natural light" } }

With urls

{ "model": "seedream-5-5", "input": { "prompt": "A cinematic scene with soft natural light", "urls": [ "https://example.com/input.jpg" ] } }

Constraints

  • resolution: allowed: 1K, 1.5K, 2K.
  • background: allowed: auto, transparent, opaque.
  • outputFormat: allowed: jpeg, png.
  • promptOptimizeMode: allowed: standard.
  • One image per task. Layer decomposition and OCR are not exposed by this endpoint.
  • Transparent backgrounds require PNG. Prompt optimization is always enabled; only standard is accepted.
  • Exact dimensions require positive integer width and height, 921,600–4,624,220 total pixels, and width/height from 1/16 to 16. Omit resolution for exact dimensions, tier sizes or auto.
  • Every reference image is billed, including the first. Output billing uses 1K pricing for 1K/1.5K or exact sizes up to 2,610,000 pixels; 2K pricing applies above that threshold. Omitted size or auto defaults to 2K. Each input adds reference_image at 1K/1.5K or reference_image_2K at 2K.

Invalid types, unsupported enum values, out-of-range numbers, and missing required fields return HTTP 400 with error.code: "invalid_input". Correct the request rather than retrying it unchanged.

Result

Poll the task or provide a top-level webhook URL in the create request:

curl https://api.api-stock.com/api/v1/task/status/$TASK_ID \ -H "Authorization: Bearer $API_STOCK_KEY"

A successful media task returns one or more files:

{ "code": 200, "data": { "taskId": "019ca881-9503-7270-a560-f00fc2b15785", "status": "finished", "files": [ { "fileUrl": "https://s3.api-stock.com/result.png", "fileType": "image" } ], "createdTime": "2026-08-22T12:00:00.000Z" } }

See Tasks and webhooks for terminal statuses, retries and webhook delivery.