Seedream 5.5
Use seedream-5-5 to create image output. This page contains the complete request needed for this model.
Model facts
| Property | Value |
|---|---|
| Model ID | seedream-5-5 |
| Endpoint | POST /api/v1/generation/create |
| Output | Image |
| Modes | text-to-image, image-to-image |
| Pricing | View 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.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | Yes | — | Text description for image generation or editing |
urls | string[] | 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. |
size | string | No | "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.