byteplus/seedream-5-0-pro-260628, servida por Comfy Router desde BytePlus.
Entrada: Texto, Imagen · Salida: Imagen
Inicio rápido
Crea una clave en tu espacio de trabajo de Comfy y expórtala comoCOMFY_API_KEY. Los fragmentos de Python y TypeScript usan los SDK de Comfy (pip install comfy-sdk y npm install @comfyorg/sdk); el fragmento de cURL es la misma llamada sobre HTTP puro.
ID del modelo: byteplus/seedream-5-0-pro-260628
Endpoint: POST https://api.comfy.org/v2/models/byteplus/seedream-5-0-pro-260628
- Esperar el resultado
- Encolar y recoger más tarde
El mismo cuerpo, enviado a
POST https://api.comfy.org/v2/models/byteplus/seedream-5-0-pro-260628/requests. Router responde 201 con un request_id en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. Entrega en cola recorre el estado, la cancelación y la recogida.Esquema
Entrada
number
Controla qué tan fielmente se alinea la imagen de salida con el prompt de entrada. Rango [1, 10]. Los valores más altos producen una mayor adherencia al prompt. No es compatible con seedream-5.0-pro, 5.0-lite, 4.5 y 4.0.Rango:
1 a 10Formato: floatstring | string[]
La imagen o las imágenes a editar, como una URL accesible o una carga útil Base64 con prefijo data-URI. Idéntico al campo compartido de Seedream, excepto por el límite de imágenes de referencia, que es 10 en este modelo en lugar de 14.
boolean
predeterminado:"false"
Controla si se habilita la separación de capas. Solo seedream-5.0-pro y 5.0-flash admiten este parámetro.
true: Modo de separación de capas. El modelo descompone la única imagen de entrada en una imagen base más varias capas (hasta 16) y devuelve la información de posición y contenido de cada capa producida, incluidos el orden de apilamiento (z_index), la caja delimitadora (bounding_box), el nombre (name) y la descripción (description).
false: Modo estándar de generación de imágenes; no se realiza separación de capas.
Notas sobre el modo de separación de capas: solo se admite una única imagen de entrada (pasar varias imágenes devuelve un error); si alguna capa individual no se genera, toda la solicitud falla, no se admite el éxito parcial; se devuelven como máximo 17 imágenes (1 imagen base + 16 capas). sequential_image_generation, sequential_image_generation_options, tools y stream devuelven un error si los pasas.
string
Identificador del modelo. Modelos admitidos: seedream-4-0-250828, seedream-4-5-251128, seedream-5-0-260128, seedream-5-0-pro-260628 y seedream-5-0-flash-260915. Una llamada directa v1 a POST /proxy/byteplus/api/v3/images/generations DEBE proporcionarlo: el proxy rechaza cualquier otro valor y rechaza uno omitido con un 400. NO está en la lista
required de este esquema porque Comfy Router lo rellena desde el segmento de ruta {model} de /v2/models/byteplus/{model}, así que quien llama desde Router lo omite.object
Configuración para la función de optimización del prompt. Solo seedream-5.0-pro/5.0-lite/4.5 (que solo admiten el modo standard) y seedream-4.0 admiten este parámetro.
string
predeterminado:"\"standard\""
Establece el modo para la función de optimización del prompt. standard = Mayor calidad, mayor tiempo de generación. fast = Más rápido, pero con una calidad más media.Posibles valores:
standard, faststring
predeterminado:"\"jpeg\""
Especifica el formato de la imagen de salida. Solo seedream-5.0-pro, 5.0-flash y 5.0-lite admiten este parámetro. En el escenario de separación de capas, output_format solo controla el formato de la imagen base; cada capa siempre se genera como png.Posibles valores:
png, jpegstring
Descripción de texto para la generación o transformación de imágenes.
Opcional en el escenario de separación de capas (seedream-5.0-pro o 5.0-flash con layer_decomposition habilitado): si incluyes un prompt, el modelo reconoce y separa los elementos que especifiques según la intención del prompt; si no incluyes ninguno, el modelo detecta automáticamente todos los elementos principales de la imagen y los separa en capas independientes.
string
predeterminado:"\"url\""
Especifica el formato de la imagen generada que se devuelve en la respuesta.Posibles valores:
url, b64_jsoninteger
predeterminado:"-1"
Semilla aleatoria para controlar la estocasticidad de la generación de imágenes. Rango: [-1, 2147483647]. Si no se especifica, se generará una semilla automáticamente. Para reproducir la misma salida, usa el mismo valor de semilla.Rango:
-1 a 2147483647string
Controla si se deshabilita la función de generación por lotes. Este parámetro solo es compatible con seedream-5.0-lite, 4.5 y 4.0 (no es compatible con seedream-5.0-pro ni 5.0-flash). Valores válidos:
auto: En el modo automático, el modelo determina automáticamente si devolver varias imágenes y cuántas imágenes contendrá según el prompt del usuario.
disabled: Deshabilita la función de generación por lotes. El modelo solo generará una imagen.Posibles valores:
auto, disabledobject
Solo seedream-5.0-lite, 4.5 y 4.0 admiten este parámetro (no es compatible con seedream-5.0-pro ni 5.0-flash).
Configuración para la función de generación de imágenes por lotes. Este parámetro solo tiene efecto cuando sequential_image_generation se establece en auto.
integer
predeterminado:"15"
Especifica el número máximo de imágenes a generar en esta solicitud. Número de imágenes de referencia de entrada + Número de imágenes generadas ≤ 15.Rango:
1 a 15string
“seedream-4-0-250828”: Establece la especificación de la imagen generada. Hay dos métodos disponibles, pero no se pueden usar juntos.
Método 1 | Especifica la resolución. Valores opcionales: 1K, 2K, 4K
Método 2 | Especifica el ancho y el alto en píxeles. Predeterminado: 2048x2048, píxeles totales: [1024x1024, 4096x4096], relación de aspecto: [1/16, 16]
“seedream-4-5-251128”: Dos métodos disponibles.
Método 1 | Especifica la resolución. Valores opcionales: 2K, 4K
Método 2 | Especifica el ancho y el alto en píxeles. Predeterminado: 2048x2048, píxeles totales: [2560x1440, 4096x4096], relación de aspecto: [1/16, 16]
“seedream-5-0-260128”: Dos métodos disponibles.
Método 1 | Especifica la resolución. Valores opcionales: 2K, 3K
Método 2 | Especifica el ancho y el alto en píxeles. Predeterminado: 2048x2048, píxeles totales: [2560x1440, ~3072x3072], relación de aspecto: [1/16, 16]
“seedream-5-0-pro-260628”: Dos métodos disponibles (no se pueden usar juntos).
Método 1 | Especifica la resolución y describe en el prompt la relación de aspecto, la forma o el propósito de la imagen; el modelo decide el tamaño final. Valores opcionales: 1K, 2K
Método 2 | Especifica el ancho y el alto en píxeles. Predeterminado: 1024x1024, total de píxeles: [1024x1024 (1048576), 2048x2048 (4194304)], relación de aspecto: [1/16, 16]
“seedream-5-0-flash-260915”: Dos métodos disponibles (no se pueden usar juntos).
Método 1 | Especifica la resolución y describe en el prompt la relación de aspecto, la forma o el propósito de la imagen; el modelo decide el tamaño final. Valores opcionales: 1K, 1.5K, 2K. Predeterminado: 2K
Método 2 | Especifica el ancho y el alto en píxeles. Total de píxeles: [1280x720 (921600), 2048x2048x1.1025 (4624220)], relación de aspecto: [1/16, 16]
“seedream-5-0-pro-260628” y “seedream-5-0-flash-260915” con layer_decomposition habilitado: Solo se admite el método basado en la resolución. Valores opcionales: 1K, 1.5K, 2K, auto. Predeterminado: auto.
La imagen base se genera en la resolución especificada con la relación de aspecto de la imagen de entrada original; cada capa se genera cerca de la resolución especificada, manteniendo la relación de aspecto que tenía en la imagen original.
auto: La salida se basa en el tamaño y la relación de aspecto de la imagen de entrada. Las entradas dentro de [1280x720, ~2048x2048] se generan con el tamaño original de la entrada; las entradas menores que 1K se generan en 1K; las entradas mayores que 2K se generan en 2K.
boolean
predeterminado:"false"
Comfy Router fija en false un flag stream proporcionado explícitamente, ya que captura un resultado JSON completo. En el proxy v1, este campo controla si habilitar el modo de salida en streaming. Solo seedream-5.0-lite, 4.5 y 4.0 admiten este parámetro (seedream-5.0-pro y 5.0-flash no lo admiten). false = Todas las imágenes de salida se devuelven a la vez. true = Cada imagen de salida se devuelve inmediatamente después de generarse.
boolean
predeterminado:"true"
Especifica si se agrega una marca de agua a la imagen generada. false = Sin marca de agua, true = Agrega una marca de agua con la etiqueta ‘AI generated’
GET /v2/models/byteplus/seedream-5-0-pro-260628/openapi.json, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor.
Salida
integer
Marca de tiempo Unix (en segundos) que indica cuándo se creó la solicitud
object[]
Contiene información sobre las imágenes generadas.
En el escenario de separación de capas, el primer elemento del arreglo es la imagen base (z_index=0) y los elementos siguientes son las capas, ordenadas por z_index creciente.
string
Datos de imagen codificados en Base64 (si response_format es “b64_json”)
object
La información de la caja delimitadora de la región que ocupa la capa actual dentro de la imagen base. Solo las capas devuelven este campo; la imagen base cubre todo el lienzo y no devuelve bounding_box. Se devuelve solo cuando layer_decomposition es true.
integer[]
Las coordenadas absolutas en píxeles de la caja delimitadora de la capa, en el sistema de coordenadas de la imagen base de salida con la esquina superior izquierda en (0, 0). Formato de coordenadas: [left, top, right, bottom].
integer[]
Las coordenadas cuantizadas (normalizadas) en partes por mil de la caja delimitadora de la capa, asignadas proporcionalmente a un rango entero discreto de [0, 1000] según el tamaño de la imagen base y truncadas a un máximo de 1000. Formato de coordenadas: [left, top, right, bottom].
string
Una descripción detallada del elemento separado actual, que ofrece características de capa más ricas (como color, estado y material) que name. Solo las capas devuelven este campo; la imagen base no. Se devuelve solo cuando layer_decomposition es true.
string
El nombre o etiqueta del elemento separado actual, generado automáticamente por el modelo a partir de las características del sujeto separado. Solo las capas devuelven este campo; la imagen base no. Se devuelve solo cuando layer_decomposition es true.
string
El formato de archivo de la imagen de salida. Solo seedream-5.0-pro admite este campo.
string
El ancho y el alto de la imagen en píxeles, con el formato <width>x<height>. Solo seedream-5.0-pro, 5.0-lite, 4.5 y 4.0 admiten este parámetro.
string (uri)
URL para descargar la imagen (si response_format es “url”)Formato:
uriinteger
El orden de apilamiento de la capa, que aumenta de abajo hacia arriba: 0 es la capa inferior (la imagen base) y los valores mayores quedan más arriba. Úsalo para recomponer las capas en la imagen completa con el orden de apilamiento correcto. Se devuelve solo cuando layer_decomposition es true.
object
Información de error (si la hay)
string
Código de error upstream de ModelArk. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation u OutputImageSensitiveContentDetected.DeepFake. Esta es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en las respuestas de error HTTP 400 y en las respuestas HTTP 200 de tareas fallidas sin sobrescribir los fallos de transporte.
string
Mensaje de error
string
El ID del modelo usado para la solicitud
object
integer
Número de imágenes generadas por el modelo
integer
El número de imágenes de entrada al modelo. Solo seedream-5.0-pro admite este campo.
integer
El número de tokens usados para la imagen generada por el modelo.
integer
El número total de tokens consumidos por esta solicitud.
Ejemplos
Entrada
Salida
Antes de lanzar
Los SDK crean unaIdempotency-Key y la reutilizan para los reintentos automáticos. Para los reintentos manuales, reutiliza la clave original. Router puede mantener la conexión abierta hasta 10 minutos.
Cuando una solicitud falla, Router envía un encabezado de respuesta X-Comfy-Error-Type que explica el motivo. Un 422 significa que Router rechazó la entrada antes de llamar al proveedor, y un 413 significa que el cuerpo de la solicitud era más grande de lo que Router acepta. Descarga los recursos generados de inmediato, porque las URL de resultados pueden caducar.
Cualquier límite de tamaño mencionado en la descripción de un campo más arriba es el límite propio del proveedor para ese campo, citado de la especificación del proveedor. Router aplica un tope aparte al cuerpo completo de la solicitud, con el que cuentan los medios codificados en base64: consulta tamaño del cuerpo de la solicitud.
Esta página documenta un modelo socio al que se llama a través de Comfy Router. El mismo paquete comfy-sdk / @comfyorg/sdk también incluye un segundo cliente, para ejecutar todo un gráfico de flujo de trabajo de ComfyUI en Comfy Cloud: Comfy(api_key=...) / new Comfy({ apiKey }), con client.workflows, client.assets y client.jobs. Consulta SDK de Comfy.
Encabezados
Autenticación, idempotencia, IDs de solicitud, agrupaciones de errores, ritmo de reintentos y límites de gasto.
Uso de la API de Router
Descubrimiento de modelos, errores de validación, reintentos y facturación.
Limitaciones
Lo que Router no hace hoy y qué usar en su lugar.