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