byteplus/dreamina-seedance-2-0-260128, 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 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 por HTTP sin procesar.
ID del modelo: byteplus/dreamina-seedance-2-0-260128
Endpoint: POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128
- Esperar el resultado
- Encolar y recoger más tarde
El mismo cuerpo, enviado a
POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128/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.Proveedores de servicio
Comfy Router sirve este modelo directamente, a menos que la solicitud indique otro proveedor. Los proveedores siguientes también lo sirven, en el mismo endpoint y con el mismo ID de modelo, seleccionados con el parámetro de consultamodel_provider.
- Comfy (predeterminado):
POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128 - fal, como
fal/fal-seedance-2.0:POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=fal - Higgsfield, como
higgsfield/higgsfield-seedance-2.0:POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=higgsfield - Pika, como
pika/pika-seedance-2.0:POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=pika - Runware, como
runware/runware-seedance-2.0:POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=runware - WaveSpeed, como
wavespeed/wavespeed-seedance-2.0:POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=wavespeed
strict_mode es false de forma predeterminada, así que Router traduce el cuerpo de la 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 ver todos los modelos enrutados de esta manera.
Esquema
Entrada
Ignorado. Se acepta por compatibilidad con la forma de solicitud de BytePlus, pero se elimina antes de enviar la tarea, así que nunca se envía ningún callback; consulta la ruta de estado de la tarea para obtener el resultado.Formato:
uriObjeto 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 solo audio: deben incluir al menos 1 imagen o video; Seedance 2.5 admite entrada solo de audio.
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>
Solo para Seedance 2.5. La tarea Draft que se renderizará como video final. Debe ser el único elemento de contenido.
El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type de la tarea Draft; no los envíes de nuevo. resolution toma el valor predeterminado y solo admite 1080p.
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>
El rol o la 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_audioEl 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 generará usando caracteres chinos e ingleses.Parámetros (opcional): 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)
content es un arreglo, y el límite del cuerpo por solicitud es lo que limita
todo el documento. Comfy Router (/v2/models/byteplus/{model}) es la superficie
que lo aplica; en una llamada directa a v1 /proxy, el validador propio de BytePlus
responde en su lugar. Se estableció muy por encima del tráfico real para que nunca
sea el que determine la validez de un prompt genuino; auméntalo si un cliente necesita más.El tipo del contenido de entradaValores posibles:
text, image_url, video_url, audio_url, draft_taskObjeto de video de entrada. Solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini admiten entrada de video.
URL de video o ID de recurso.
URL de video: URL pública del video (mp4, mov).
ID de recurso: Formato asset://<ASSET_ID>
Solo para 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 la tarea Draft sigue siendo válido durante 7 días.Duración del video en segundos. Seedance 2.0, 2.0 fast y 2.0 mini: [4,15] o -1 (automático).Valores posibles:
-1, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15Umbral de tiempo de espera de la tarea en segundos. Valor predeterminado 172800 (48 h). Alcance: [3600, 259200].Rango:
3600 a 259200Compatible 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 las imágenes.
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 cambia 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 solo ayuda cuando el audio fue la modalidad rechazada, que una respuesta síncrona de Router identifica 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 en su lugar.El ID del modelo 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 directa v1 a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE incluirlo; 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 desde el segmento de ruta {model} de /v2/models/byteplus/{model}, así que quien llama al Router lo omite.Solo Seedance 2.5. Formato de contenedor del video de salida.
mp4: Contenedor de uso general (H.264/AAC, yuv420p) con amplia compatibilidad y un tamaño de archivo menor.
mov: Contenedor profesional (H.264 High 4:4:4 Predictive/PCM, yuv444p) con alta precisión de color, adecuado para posproducción; tamaño de archivo mayor.Valores posibles:
mp4, movRelació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.Valores posibles: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, 9:21, adaptiveResolució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.Valores posibles:
480p, 720p, 1080p, 4kIndica 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 la consulta de información de una tarea de generación de video. La imagen del último fotograma está en formato PNG, con un 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 anteriormente 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.
Semilla entera para controlar la aleatoriedad. Alcance: [-1, 2^32-1]. -1 usa una semilla aleatoria.Rango:
-1 a 4294967295Nivel de servicio para el procesamiento. Seedance 2.5, 2.0 y 2.0 fast no admiten flex (inferencia sin conexión).Valores posibles:
default, flexGET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor.
Salida
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 REALOJAN en el almacenamiento de Comfy; cualquier otro campo de aquí es propio de BytePlus. Anulable: 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 nulo.URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud estableció
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 realoja los bytes que reciba y les asigna un tipo a partir del Content-Type del proveedor o de una detección por contenido, y image/jpeg es solo el último recurso cuando ambas fallan. Router realoja el último fotograma en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas: firmada por 24 horas cuando se emite y se reproduce desde una memo de 23 horas, por lo que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el realojamiento, 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.Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de
content. Los modelos Seedance lo devuelven 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.Hora RFC 3339 en la que las URL del proveedor dejan de funcionar: el momento de firma más temprano más la validez que las propias URL llevan, nunca posterior a
updated_at de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando updated_at está presente; en caso contrario, updated_at de la tarea más 24 horas. Solo está presente cuando lo está upstream_video_url o upstream_last_frame_url, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de video_url / last_frame_url rehospedadas.Formato: date-timeLa URL de descarga del último fotograma del propio BytePlus, devuelta byte a byte junto a
last_frame_url rehospedada y en los mismos términos que upstream_video_url: solo espacios de trabajo con la opción activada, solo Seedance 2.x, ausente una vez que BytePlus la elimina, y una credencial de portador hasta upstream_expires_at.La URL de descarga del video de salida del propio BytePlus, devuelta byte a byte junto a
video_url rehospedada. Presente SOLO para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy ha habilitado en el servidor (no hay parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave de API antigua no vinculada a uno), y ausente una vez que BytePlus elimina sus URL 24 horas después de la generación. Es una URL de almacenamiento de objetos prefirmada y por tanto una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en upstream_expires_at, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume la rehospedación del propio Router.URL de descarga del video de salida. Router realoja el video en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas: firmada por 24 horas cuando se emite y se reproduce desde una memo de 23 horas, por lo que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el realojamiento, 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.
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, devuelto en las tareas de video exitosas y reenviado sin cambios.
La información del error. Si la tarea tiene éxito, se devuelve null. Si la tarea falla, se devuelve la información del error.
Código de error de ModelArk del proveedor. 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 envolturas de error HTTP 400 y en respuestas HTTP 200 de tareas fallidas sin sobrescribir los fallos de transporte.
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.La resolución del video generado, por ejemplo
1080p. Campo propio de BytePlus, devuelto en las tareas de video exitosas y reenviado sin cambios.La semilla de generación que realmente se usó para la tarea. Campo propio de BytePlus, devuelto en las tareas de video exitosas y reenviado sin cambios.Formato:
int64La hora en que la tarea se actualizó por última vez. El valor es un timestamp UNIX en segundos.
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 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.