Seedream 5.5
Seedream 5.5
Image generation, editing and layer decomposition with 1K to 2K output, transparent backgrounds and up to 10 reference images
- Endpoint
- POST /api/v1/images/generate
- model
- seedream-5.5
- Output
- Image
- Credits
- from 6
작업 제출
/api/v1/images/generate매개변수
modelstring필수Must be "seedream-5.5"
typestring선택 사항기본값text-to-image"text-to-image", "image-to-image" or "layer-decomposition" (default: text-to-image)
text-to-imageimage-to-imagelayer-decompositionpromptstring선택 사항Text prompt, 5 to 5,000 characters; required except for layer decomposition, where it is an optional hint of up to 2,000 characters.
sizestring선택 사항기본값2K"1K", "1.5K" or "2K" (default: 2K). Layer decomposition also accepts "auto" (default), which keeps the source size and is priced like 2K.
1K1.5K2Kautoaspect_ratiostring선택 사항기본값auto"1:1", "4:3", "3:4", "16:9", "9:16", "2:3", "3:2" or "21:9" (default: 1:1). Image-to-image also accepts "auto" (default). Ignored for layer decomposition.
1:14:33:416:99:162:33:221:9autoimage_urlsstring[]선택 사항Public https URLs. Image-to-image: 1 to 10 images, each adds 2 credits. Layer decomposition: exactly 1 image.
output_formatstring선택 사항기본값png"png" or "jpeg" (default: png)
pngjpegbackgroundstring선택 사항기본값auto"auto", "transparent" or "opaque" (default: auto). Transparent needs png. Not used by layer decomposition.
autotransparentopaquemax_imagesnumber선택 사항기본값10Layer decomposition only: the most images to return, base image included, 2 to 30 (default: 10). Credits are held for this many images and the unused part is returned when the task completes.
text_recognitionboolean선택 사항기본값falseLayer decomposition only: also split text into its own layers (default: false)
truefalsenum_imagesnumber선택 사항Must be 1
요청
curl -X POST https://www.bananapro.site/api/v1/images/generate \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream-5.5",
"prompt": "A cozy reading nook by a rainy window, warm lamp light, film grain",
"size": "2K",
"aspect_ratio": "3:2",
"output_format": "png"
}'응답200
{
"success": true,
"data": {
"task_id": "task_abc123",
"request_id": "req_abc123",
"credits_used": 9,
"remaining_credits": 480,
"model": "seedream-5.5",
"size": "2K"
}
}예시의 credits_used 값은 참고용입니다. 실제 사용량은 제출 시 계산되어 API가 반환합니다.
작업 조회
/api/v1/images/{task_id}status
pending- Accepted and waiting to start. Keep polling.
processing- Running. Keep polling.
completed- Finished. Read image_url; output holds the full result.
failed- Ended without a result. error_message says why and credits_refunded shows what was returned.
Poll every 5 to 10 seconds and stop at completed or failed, or register a webhook to be notified instead. Failed tasks are refunded automatically.
요청
curl https://www.bananapro.site/api/v1/images/task_abc123 \
-H "Authorization: Bearer sk-your-api-key"응답200
{
"success": true,
"data": {
"task_id": "task_abc123",
"model": "seedream-5.5",
"status": "completed",
"output": { "images": [{ "url": "https://..." }] },
"primary_url": "https://...",
"image_url": "https://...",
"error_message": null,
"credits_used": 9,
"credits_refunded": 0,
"created_at": "2026-10-04T10:00:00.000Z",
"updated_at": "2026-10-04T10:01:12.000Z",
"completed_at": "2026-10-04T10:01:12.000Z"
},
"request_id": "req_abc123"
}결과 기다리기
TASK_ID=task_abc123
while true; do
TASK=$(curl -s https://www.bananapro.site/api/v1/images/$TASK_ID \
-H "Authorization: Bearer sk-your-api-key")
STATUS=$(echo "$TASK" | jq -r '.data.status')
if [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ]; then
echo "$TASK" | jq
break
fi
sleep 10
done요금제
| Size | Image to image (1 reference) | Text to image |
|---|---|---|
| 1K | 8 | |
| 1.5K | 8 | |
| 2K | 11 |
기능
- Text-to-image generation
- Image-to-image editing with up to 10 reference images
- Layer decomposition: split an image into a base image and separate layers
- 1K, 1.5K and 2K output
- PNG or JPEG output, with an optional transparent background