Seedream 5 Pro Image API Reference

Seedream 5 Pro

Professional image generation and editing with up to 10 reference images, 1K/2K output, and precise instruction following

Endpoint: POST /api/v1/images/generate
model: seedream-5-pro
Output: Image
Credits: from 20

Enviar una tarea

POST/api/v1/images/generate

Parámetros

modelstringNecesario
Must be "seedream-5-pro"
typestringOpcionalPredeterminado text-to-image
"text-to-image" or "image-to-image" (default: text-to-image)
text-to-imageimage-to-image
promptstringNecesario
Prompt de texto para generar la imagen. Admite inglés y chino. Recomendación: no más de 600 palabras en inglés; demasiada información puede dispersar los detalles y hacer que falten elementos.
generation_modestringOpcionalPredeterminado standard
"economy" or "standard". Existing API clients that omit this field keep the Standard-mode default.
economystandard
resolutionstringOpcionalPredeterminado 1K
"1K" or "2K" (default: 1K)
1K2K
aspect_ratiostringOpcionalPredeterminado 1:1
"1:1", "4:3", "3:4", "16:9", "9:16", "2:3", or "3:2". Standard mode also supports "21:9" (default: 1:1)
1:14:33:416:99:162:33:221:9
image_urlsstring[]Opcional
Input image URLs for image-to-image. Supports up to 10 JPEG, PNG, or WebP images. Economy mode supports up to 10MB per image; Standard mode supports up to 30MB. Each image adds 1 credit.
input_imagestringOpcional
Deprecated. Alias for image_urls[0]
num_imagesnumberOpcional
Must be 1

Solicitud

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-pro",
    "prompt": "A premium ecommerce product photo of a translucent smart speaker on a glass table, soft daylight, crisp details",
    "generation_mode": "economy",
    "resolution": "2K",
    "aspect_ratio": "16:9"
  }'

Respuesta200

JSON

{
  "success": true,
  "data": {
    "task_id": "task_seedream5pro_abc123",
    "request_id": "req_abc123",
    "credits_used": 20,
    "remaining_credits": 480,
    "model": "seedream-5-pro",
    "generation_mode": "economy",
    "resolution": "2K"
  }
}

Los valores de credits_used de estos ejemplos son ilustrativos. El consumo real se calcula al enviar y lo devuelve la API.

Consultar la tarea

GET/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.

Solicitud

curl https://www.bananapro.site/api/v1/images/task_abc123 \
  -H "Authorization: Bearer sk-your-api-key"

Respuesta200

JSON

{
  "success": true,
  "data": {
    "task_id": "task_abc123",
    "model": "seedream-5-pro",
    "status": "completed",
    "output": { "images": [{ "url": "https://..." }] },
    "primary_url": "https://...",
    "image_url": "https://...",
    "error_message": null,
    "credits_used": 20,
    "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"
}

Esperar el resultado

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

Precios

Mode	1K	2K
Economy	10
Standard	13

Características

Text-to-image generation
Image-to-image editing
Multi-image fusion with up to 10 reference images
1K and 2K output
Economy and Standard generation modes
Single-image output per request

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-pro", "prompt": "A premium ecommerce product photo of a translucent smart speaker on a glass table, soft daylight, crisp details", "generation_mode": "economy", "resolution": "2K", "aspect_ratio": "16:9" }'

{ "success": true, "data": { "task_id": "task_seedream5pro_abc123", "request_id": "req_abc123", "credits_used": 20, "remaining_credits": 480, "model": "seedream-5-pro", "generation_mode": "economy", "resolution": "2K" } }

{ "success": true, "data": { "task_id": "task_abc123", "model": "seedream-5-pro", "status": "completed", "output": { "images": [{ "url": "https://..." }] }, "primary_url": "https://...", "image_url": "https://...", "error_message": null, "credits_used": 20, "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

Mode	1K	2K
Economy	10
Standard	13

Mode

Economy

Standard