Seedream 5.0 Pro

Seedream 5.0 Pro es el modelo de imágenes de ByteDance. Cada solicitud crea una imagen a partir de un prompt, de un prompt con hasta 10 imágenes de referencia, o separa una imagen en una imagen base y hasta 16 capas transparentes. Envía la solicitud, conserva el ID de tarea devuelto y lee las imágenes terminadas en la tarea. Las imágenes de referencia se envían como URL.

ID de modelo

Consulta los precios actuales en la página del modelo.

Ejemplo rápido

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-0-pro",
    "prompt": "A red ceramic mug on a white table, soft studio light, product photography. No text, no logos.",
    "size": "1K",
    "watermark": false
  }'

Endpoint

POST https://api.seedrouter.ai/v1/images/generations

La respuesta es una tarea ({"id": "task_...", "status": "processing"}), no la imagen terminada. Consulta GET /v1/tasks/{task_id} para obtener el resultado. Guarda las claves de API en código del servidor. Las referencias y la descomposición en capas van en la misma solicitud mediante image; /v1/images/edits no se usa para este modelo y devuelve 400.

Parámetros

Los campos fuera de esta lista se descartan antes de reenviar la solicitud; nunca causan errores ni cambian la salida. n, stream, seed, response_format y la generación secuencial no están disponibles. callback_url no está disponible; consulta la tarea.

Tamaño de salida

El nivel determina la escala y el prompt define la forma. Indica la relación de aspecto en prompt (por ejemplo, «un formato horizontal 16:9») y el modelo elige el encuadre:

Para un encuadre fijo, envía píxeles exactos en lugar de un nivel. 1K y 1.5K cuestan lo mismo; 2K y cualquier tamaño por encima de 2,61 millones de píxeles cuestan más (consulta Criterios de precio).

Imágenes de referencia

Pasa una imagen para editarla, o de 2–10 para combinarlas, e indica en prompt qué conservar y qué cambiar. Haz referencia a ellas por su orden («la chaqueta de la imagen 1»).

{
  "model": "seedream-5-0-pro",
  "prompt": "Put the jacket from image 1 on the model from image 2, standing on a rainy street at night.",
  "image": ["https://example.com/jacket.png", "https://example.com/model.jpg"],
  "size": "1.5K"
}

Descomposición en capas

Envía exactamente una imagen con layer_decomposition: true. La tarea devuelve primero la imagen base y después cada capa como PNG transparente.

{
  "model": "seedream-5-0-pro",
  "image": "https://example.com/poster.png",
  "layer_decomposition": true,
  "prompt": "Separate the headline, the product and the background."
}

Cada capa incluye z_index (la imagen base es 0; los números mayores se colocan encima), name, description y bounding_box. bounding_box.absolute es [left, top, right, bottom] en píxeles de la imagen base; bounding_box.normalized es la misma caja en milésimas del ancho y el alto de la imagen base. Para reconstruir la imagen, ajusta cada capa a su caja y colócala sobre la imagen base en orden ascendente de z_index.

Con size: "auto", la imagen base y cada capa conservan su tamaño en la imagen de entrada. La entrada debe ser PNG o JPEG con un total de píxeles (ancho × alto) de entre 262.144 (512 × 512) y 36.000.000 (6000 × 6000).

Fondo transparente

Envía un PNG con canal alfa y background: "transparent" para obtener un PNG de fondo transparente:

{
  "model": "seedream-5-0-pro",
  "prompt": "Turn this sticker into a glossy enamel pin, keep the outline.",
  "image": "https://example.com/sticker.png",
  "background": "transparent",
  "output_format": "png"
}

Entradas multimedia

Cada referencia es una URL pública HTTP(S). No se aceptan URI de datos Base64: sube el archivo a tu propio almacenamiento y pasa su URL. Los formatos admitidos son JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC y HEIF, hasta 30 MB cada uno, con una relación entre 1:16 y 16:1, ancho y alto superiores a 14 píxeles y un máximo de 36.000.000 píxeles en total. La descomposición en capas solo acepta PNG o JPEG.

Criterios de precio

Consulta las tarifas actuales en la sección de precios del modelo. Seedream 5.0 Pro se cobra por imagen de salida según el escenario y el nivel de píxeles, más cada imagen de referencia después de la primera:

generation:          cost = image price for its tier + extra references × reference price
layer decomposition: cost = images returned × per-image price for the request's tier

• El nivel inferior cubre imágenes de hasta 2,61 millones de píxeles (1.5K e inferiores); cualquier tamaño mayor pertenece al nivel superior.
• La descomposición en capas cobra la imagen base y cada capa. Toda la solicitud usa un único nivel: el precio inferior solo se aplica cuando todas las imágenes devueltas se mantienen dentro de los 2,61 millones de píxeles.
• El importe reservado al aceptar una tarea cubre el resultado máximo: una imagen en el nivel solicitado o 17 imágenes para descomposición en capas (auto cuenta como nivel superior). Después se cobran las imágenes realmente devueltas y se libera la diferencia.

Consulta los cargos finales en el historial de uso de tu cuenta. Las tareas fallidas no se cobran.

Esquema de salida

El envío devuelve la tarea:

{"id": "task_...", "model": "seedream-5-0-pro", "status": "processing", "created_at": 1789689600}

Consultar la tarea

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Consulta cada 10–20 segundos hasta que status sea completed o failed. Un timeout de red durante el sondeo no significa que la generación haya fallado: conserva el ID de tarea y sigue consultándolo. No crees otra tarea para comprobar el progreso.

Tarea completada

{
  "id": "task_...",
  "model": "seedream-5-0-pro",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689653,
  "output": {
    "created": 1789689650,
    "data": [
      {
        "url": "https://static.seedrouter.ai/media/tasks/task_example/0.jpg",
        "size": "1024x1024",
        "output_format": "jpeg"
      }
    ],
    "usage": { "output_tokens": 4096, "total_tokens": 4096 }
  }
}

Una tarea de descomposición en capas enumera la imagen base y después cada capa:

{
  "data": [
    { "url": "https://static.seedrouter.ai/media/tasks/task_example/0.jpg", "size": "832x1248", "output_format": "jpeg", "z_index": 0 },
    {
      "url": "https://static.seedrouter.ai/media/tasks/task_example/1.png",
      "size": "527x1044",
      "output_format": "png",
      "z_index": 1,
      "name": "Ceramic coffee cup",
      "description": "White ceramic cup with a matte glaze, extracted without the table.",
      "bounding_box": { "absolute": [212, 418, 610, 1206], "normalized": [255, 335, 733, 966] }
    }
  ]
}

En nuestras pruebas, una imagen 1K tardó unos 35–55 segundos, y una descomposición en capas en 1K que devolvió una imagen base y 13 capas tardó unos 140 segundos.

Errores

Las solicitudes rechazadas antes de crear una tarea devuelven un error HTTP con un objeto error y no se cobran. Una tarea que falla después de aceptarse devuelve HTTP 200 al consultarla, con status: "failed" y un objeto error.

Consulta el catálogo común de errores para ver códigos, estados HTTP y recomendaciones para reintentos.

{
  "id": "task_...",
  "model": "seedream-5-0-pro",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Si el propio envío agota el tiempo de espera, consulta tus tareas antes de volver a enviarlo: la primera solicitud podría haberse aceptado.

Consejos

• Empieza en 1K o 1.5K para hacer pruebas; 1.5K cuesta lo mismo que 1K.
• Indica la forma en el prompt al usar un nivel, o envía píxeles exactos para una composición fija.
• Con varias referencias, explica qué aporta cada una y haz referencia a ellas por su orden.
• Usa watermark: false cuando necesites una imagen sin marca; el valor predeterminado añade una.
• Para la descomposición en capas, enumera los elementos que quieres separar para mantener bajo el número de capas.

Relacionado

• Playground y precios de Seedream 5.0 Pro
• Descargar OpenAPI
• Markdown para copiar