Skip to main content
Referencia de API para byteplus/dreamina-seedance-2-5-260628, servida por Comfy Router desde BytePlus. Entrada: Texto, Imagen, Video, Audio · Salida: Video + Audio

Inicio rápido

Crea una clave en tu espacio de trabajo de Comfy y expórtala como COMFY_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 sin procesar. ID del modelo: byteplus/dreamina-seedance-2-5-260628 Endpoint: POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628
El mismo cuerpo, enviado a POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/requests. Router responde 201 con un request_id en cuanto se admite la ejecución, y recoges el resultado cuando está listo, desde este proceso o desde otro. Entrega en cola explica el estado, la cancelación y la recogida.

Proveedores de servicio

Comfy Router sirve este modelo directamente, a menos que la solicitud indique otro proveedor. Los siguientes proveedores también lo sirven, en el mismo endpoint y con el mismo ID de modelo, y se seleccionan con el parámetro de consulta model_provider.
  • Comfy (predeterminado): POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628
  • fal, como fal/fal-seedance-2.5: POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628?model_provider=fal
  • Higgsfield, como higgsfield/higgsfield-seedance-2.5: POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628?model_provider=higgsfield
  • Runware, como runware/runware-seedance-2.5: POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628?model_provider=runware
  • WaveSpeed, como wavespeed/wavespeed-seedance-2.5: POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628?model_provider=wavespeed
strict_mode tiene como valor predeterminado false, así que Router traduce el cuerpo de solicitud nativo documentado en esta página al esquema propio del proveedor y traduce la respuesta de vuelta. Consulta model_provider, strict_mode y fallback_provider en la referencia de la API, y Proveedores de servicio para todos los modelos que se enrutan de esta forma.

Esquema

Entrada

string (uri)
Dirección de notificación de callback para el resultado de esta tarea de generaciónFormato: uri
object[]
requerido
El contenido de entrada para que el modelo genere un video
object
Objeto de audio de entrada. Solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini admiten entrada de audio. Seedance 2.0, 2.0 fast y 2.0 mini no pueden usar audio por sí solo: deben incluir al menos 1 imagen o video; Seedance 2.5 admite entrada solo de audio.
string
requerido
URL de audio, codificación Base64 o ID de recurso. URL de audio: URL pública del audio (wav, mp3). Base64: Formato data:audio/<format>;base64,<content> ID de recurso: Formato asset://<ASSET_ID>
object
Solo Seedance 2.5. La tarea Draft que se va a renderizar como video final. Debe ser el único elemento de contenido. El video final reutiliza el prompt de la tarea Draft, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type; no los envíes de nuevo. resolution toma el valor predeterminado 1080p y solo admite 1080p.
string
requerido
El ID de tarea devuelto cuando el video Draft se creó con draft establecido en true.
object
string
requerido
Contenido de imagen para la generación de imagen a video (cuando type es “image_url”) URL de imagen: asegúrate de que la URL de la imagen sea accesible. Contenido codificado en Base64: el formato debe ser data:image/<format>;base64,<content> ID de recurso: Formato asset://<ASSET_ID>
string
El rol/posición del elemento de contenido. Para imágenes: first_frame, last_frame o reference_image. Para videos: reference_video (solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini). Para audio: reference_audio (solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini).Valores posibles: first_frame, last_frame, reference_image, reference_video, reference_audio
string
La información de texto de entrada para el modelo. Incluye el prompt de texto y parámetros opcionales.Prompt de texto (requerido): descripción del video que se va a generar con caracteres chinos e ingleses.Parámetros (opcionales): agrega —[parameters] después del prompt de texto para controlar las especificaciones del video:
  • —resolution (—rs): 480p, 720p, 1080p (predeterminado: 720p)
  • —ratio (—rt): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, adaptive (predeterminado: 16:9 o adaptive)
  • —duration (—dur): 3-12 segundos (predeterminado: 5)
  • —framepersecond (—fps): 24 (predeterminado: 24)
  • —watermark (—wm): true/false (predeterminado: false)
  • —seed (—seed): -1 a 2^32-1 (predeterminado: -1)
  • —camerafixed (—cf): true/false (predeterminado: false)
Ejemplo: “A beautiful landscape —ratio 16:9 —resolution 720p —duration 5”Límite de protección del lado de Comfy, no una restricción de BytePlus. BytePlus no publica un límite de longitud de texto y aceptó 40,000 caracteres en pruebas (2026-09-17). Cuenta caracteres, no bytes, así que un prompt multibyte puede ocupar varias veces este tamaño en el envío. Acota este campo, no la solicitud: content es un arreglo y el límite del cuerpo por solicitud es el que acota el documento completo. Comfy Router (/v2/models/byteplus/{model}) es la superficie que lo aplica; en una llamada directa a v1 /proxy responde el validador propio de BytePlus. Está configurado muy por encima del tráfico real para que nunca juzgue un prompt genuino: auméntalo si quien llama necesita más.
string
requerido
El tipo del contenido de entradaValores posibles: text, image_url, video_url, audio_url, draft_task
object
Objeto de video de entrada. Solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini admiten entrada de video.
string
requerido
URL de video o ID de recurso. URL de video: URL pública del video (mp4, mov). ID de recurso: Formato asset://<ASSET_ID>
boolean
predeterminado:"false"
Solo Seedance 2.5. Genera un video Draft en 480p; la resolución debe ser 480p. Pasa el ID de tarea devuelto en un elemento de contenido draft_task para renderizar el video final en 1080p. El ID de tarea Draft sigue siendo válido durante 7 días.
`-1` | object
Duración del video en segundos. Seedance 2.5: [4,30] o -1 (automático; las tareas de edición de video solo admiten -1). Seedance 2.0, 2.0 fast y 2.0 mini: [4,15] o -1 (automático). Seedance 1.5 pro: [4,12] o -1. Seedance 1.0: [2,12].Rango: 2 a 30
integer
Umbral de tiempo de espera de la tarea en segundos. Predeterminado 172800 (48 h). Alcance: [3600, 259200].Rango: 3600 a 259200
boolean
predeterminado:"true"
Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con lo visual. true: el modelo genera un video con audio sincronizado. false: el modelo genera un video silencioso. En los modelos que lo admiten, el proveedor revisa el contenido de la pista de audio generada por separado del video; un rechazo allí se informa como content_policy_violation y, como el audio varía en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía false para obtener un video silencioso si eso ocurre; esto ayuda solo cuando el audio era la modalidad rechazada, que una respuesta síncrona del Router nombra como refusal_subject: output_audio (una solicitud en cola aún no lo identifica). Un render final de Seedance 2.5 hereda generate_audio de su tarea Draft, así que vuelve a crear el Draft con false.
string
El ID del modelo al que se va a llamar. Modelos compatibles: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini y dreamina-seedance-2-5-260628. Una llamada v1 directa a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE proporcionarlo: el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO está en la lista required de este esquema porque Comfy Router lo rellena a partir del segmento de ruta {model} de /v2/models/byteplus/{model}, así que quien llama a través del Router lo omite.
string
predeterminado:"\"mp4\""
Solo Seedance 2.5. Formato de contenedor del video de salida. mp4: Contenedor de uso general (H.264/AAC, yuv420p) con amplia compatibilidad y menor tamaño de archivo. mov: Contenedor profesional (H.264 High 4:4:4 Predictive/PCM, yuv444p) con alta precisión de color, adecuado para posproducción; mayor tamaño de archivo.Posibles valores: mp4, mov
string
Relación de aspecto del video generado. Seedance 2.0, 2.0 fast y 2.0 mini, 1.5 pro por defecto: adaptive. Generación de primer fotograma / primer y último fotograma de Seedance 2.5: la salida sigue la relación de aspecto del primer fotograma, así que solo se acepta adaptive (u omitir el campo); una relación concreta se rechaza con un 400 antes del despacho. Seedance 2.0 acepta una relación concreta en esos modos.Posibles valores: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, 9:21, adaptive
string
Resolución del video. Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro, 1.0 lite por defecto: 720p. Seedance 1.0 pro y pro-fast por defecto: 1080p. Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p y 1080p.Posibles valores: 480p, 720p, 1080p, 4k
boolean
predeterminado:"false"
Si se devuelve la imagen del último fotograma del video generado. true: Devuelve la imagen del último fotograma del video generado. Después de establecer este parámetro en true, puedes obtener la imagen del último fotograma llamando a Querying the information about a video generation task. La imagen del último fotograma está en formato PNG, con su ancho y alto en píxeles coherentes con los del video generado, y no contiene marcas de agua. Usar este parámetro permite generar varios videos consecutivos: el último fotograma del video generado previamente se usa como primer fotograma de la siguiente tarea de video, lo que permite generar rápidamente varios videos consecutivos. false: No devuelve la imagen del último fotograma del video generado.
integer
Semilla entera para controlar la aleatoriedad. Alcance: [-1, 2^32-1]. -1 usa una semilla aleatoria.Rango: -1 a 4294967295
string
Nivel de servicio para el procesamiento. Seedance 2.5, 2.0 y 2.0 fast no admiten flex (inferencia sin conexión).Posibles valores: default, flex
boolean
predeterminado:"false"
Si el video generado incluye una marca de agua.
Generado a partir del esquema que Router sirve en GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor.

Salida

object
La salida una vez completada la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus la devuelve, la URL de descarga de su último fotograma. Tanto video_url como last_frame_url se RE-ALOJAN en el almacenamiento de Comfy; todos los demás campos aquí son propios de BytePlus. Admite null: BytePlus borra las URL 24 horas después de la tarea, y un documento con estado succeeded consultado después de eso puede traer content ausente o null.
string
URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud establece return_last_frame. No infieras el formato de imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG en el lado de la solicitud, Router vuelve a alojar los bytes que recibe y les asigna un tipo a partir del Content-Type del upstream o de una inspección del contenido, e image/jpeg es solo el respaldo de último recurso cuando ambos fallan. Router vuelve a alojar el último fotograma en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida hasta 24 horas: se firma por 24 horas al generarse y se reproduce desde una memo de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso, el enlace caduca, así que descarga el fotograma en lugar de guardar la URL.
string
Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de content. Los modelos Seedance suelen devolverlo más comúnmente como un hermano de NIVEL SUPERIOR de content (consulta el campo output_format de nivel superior), y Router lee el que de los dos esté presente.
string
URL de descarga del video de salida. Router vuelve a alojar el video en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida hasta 24 horas: se firma por 24 horas al generarse y se reproduce desde una memo de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso, el enlace caduca, así que descarga el video en lugar de guardar la URL.
integer
La hora en que se creó la tarea. El valor es una marca de tiempo UNIX en segundos.
number
La duración del video generado en segundos. Se declara como un número en lugar de un entero porque BytePlus no es consistente al respecto: se ha observado que las tareas de video devuelven segundos enteros y otras superficies hermanas de BytePlus reportan duraciones fraccionarias, así que un cliente no debe asumir un valor entero. Campo propio de BytePlus, que se devuelve en las tareas de video con estado succeeded y se reenvía sin cambios.
object
La información del error. Si la tarea tiene éxito, se devuelve null. Si la tarea falla, se devuelve la información del error.
string
Código de error del 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 sobres de error HTTP 400 y en respuestas HTTP 200 de tareas fallidas sin sobrescribir los fallos de transporte.
string
El mensaje de error
string
El ID de la tarea de generación de video
string
El nombre y la versión del modelo utilizado por la tarea
string
Formato de contenedor del video generado (mp4 o mov), devuelto en el NIVEL SUPERIOR como hermano de content: aquí es donde lo devuelve la consulta de tareas de video de Seedance. Campo propio de BytePlus, reenviado sin cambios.
string
La resolución del video generado, por ejemplo 1080p. Campo propio de BytePlus, que se devuelve en las tareas de video con estado succeeded y se reenvía sin cambios.
integer
La semilla de generación que se usó realmente para la tarea. Campo propio de BytePlus, que se devuelve en las tareas de video con estado succeeded y se reenvía sin cambios.Formato: int64
string
El estado de la tareaValores posibles: queued, running, cancelled, succeeded, failed, expired
integer
La hora en que la tarea se actualizó por última vez. El valor es una marca de tiempo UNIX en segundos.
object
El uso de tokens de la solicitud
integer
El número de tokens generados por el modelo
integer
Para el modelo de generación de video, el número de tokens de entrada no se calcula y es 0 por defecto. Por lo tanto, total_tokens = completion_tokens.

Ejemplos

Entrada

Salida

Antes de lanzar

Los SDK crean una Idempotency-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.