# Seedance 2.0 API Referencia completa de la API de los modelos de generación de vídeo Seedance 2.0 de ByteDance. ## Variantes de modelos Esta API admite seis variantes: | Modelo | ID | Descripción | |-------|-----|-------------| | **Seedance 2.0 Text to Video** | `seedance-v2.0-text-to-video` | Generación de vídeo de alta calidad a partir de texto | | **Seedance 2.0 Image to Video** | `seedance-v2.0-image-to-video` | Animación de imágenes con control del movimiento | | **Seedance 2.0 Reference to Video** | `seedance-v2.0-reference-to-video` | Generación de vídeo guiada por un vídeo de referencia | | **Seedance 2.0 Fast Text to Video** | `seedance-v2.0-fast-text-to-video` | Generación de vídeo más rápida a partir de texto | | **Seedance 2.0 Fast Image to Video** | `seedance-v2.0-fast-image-to-video` | Generación de vídeo más rápida a partir de imágenes | | **Seedance 2.0 Fast Reference to Video** | `seedance-v2.0-fast-reference-to-video` | Generación de vídeo guiada por referencias más rápida | ## Comparación rápida | Función | Modelos estándar | Modelos Fast | |---------|-----------------|-------------| | Calidad | Mayor calidad | Optimizados para la velocidad | | Tiempo de procesamiento | 3-8 minutos | 1-4 minutos | | Intervalo de duración | 4-15 segundos | 4-15 segundos | | Opciones de resolución | 480p, 720p, 1080p, 4k | 480p, 720p | | Medios de referencia | Imágenes, vídeos y audios para Reference-to-Video | Imágenes, vídeos y audios para Fast Reference-to-Video | ### Relaciones de aspecto admitidas `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` ### Opciones de resolución | Resolución | Descripción | |------------|-------------| | `480p` | Definición estándar, procesamiento más rápido | | `720p` | Alta definición, equilibrio entre calidad y velocidad | | `1080p` | Full HD, disponible en todos los modelos estándar de Seedance 2.0 | | `4k` | Ultra HD, disponible en todos los modelos estándar de Seedance 2.0 | ## Seedance 2.0 Texto a vídeo ### Punto de conexión ``` POST /api/v1/video/task ``` ### Parámetros de solicitud #### Obligatorios | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `model_name` | string | Debe ser `"seedance-v2.0-text-to-video"` | | `prompt` | string | Prompt de generación de vídeo | | `duration` | integer | Duración del vídeo en segundos enteros (4-15), en incrementos de 1 | | `resolution` | string | Resolución de salida: `"480p"`, `"720p"`, `"1080p"` o `"4k"` | | `aspect_ratio` | string | Relación de aspecto del vídeo: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` o `"3:4"` | #### Opcionales | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `sound` | boolean | Indica si se genera sonido. Valor predeterminado: `true`; no afecta al precio | ### Ejemplo de solicitud ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'seedance-v2.0-text-to-video', prompt: 'A golden retriever running through a sunlit meadow', duration: 6, resolution: '720p', aspect_ratio: '16:9' }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Seedance 2.0 Imagen a vídeo ### Parámetros de solicitud #### Obligatorios | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `model_name` | string | Debe ser `"seedance-v2.0-image-to-video"` | | `prompt` | string | Prompt de generación de vídeo | | `duration` | integer | Duración del vídeo en segundos enteros (4-15), en incrementos de 1 | | `resolution` | string | Resolución de salida: `"480p"`, `"720p"`, `"1080p"` o `"4k"` | | `aspect_ratio` | string | Relación de aspecto del vídeo: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` o `"3:4"` | | `image_url` | string | Primer fotograma del vídeo | #### Opcionales | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `image_end_url` | string | URL opcional de la imagen del fotograma final | | `sound` | boolean | Indica si se genera sonido. Valor predeterminado: `true`; no afecta al precio | ### Ejemplo de solicitud ```javascript { model_name: 'seedance-v2.0-image-to-video', image_url: 'https://example.com/image.jpg', image_end_url: 'https://example.com/end-frame.jpg', prompt: 'Camera slowly pulls back to reveal the full landscape', duration: 6, resolution: '720p', aspect_ratio: '16:9' } ``` ## Seedance 2.0 Referencias a vídeo ### Parámetros de solicitud #### Obligatorios | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `model_name` | string | Debe ser `"seedance-v2.0-reference-to-video"` | | `prompt` | string | Prompt de generación de vídeo. Escribe un prompt estándar sin marcadores o utiliza opcionalmente la función de referencia @ (AT) con `<<>>`, `<<>>` y `<<>>` para referenciar explícitamente los elementos de las matrices de medios correspondientes | | `duration` | integer | Duración del vídeo en segundos enteros (4-15), en incrementos de 1 | | `resolution` | string | Resolución de salida: `"480p"`, `"720p"`, `"1080p"` o `"4k"` | | `aspect_ratio` | string | Relación de aspecto del vídeo: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` o `"3:4"` | #### Medios de referencia Envía 1-9 imágenes. Solo pueden omitirse si se proporciona al menos un vídeo de referencia. | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `images` | string[] | 1-9 URL de imágenes de referencia, o una matriz vacía cuando `videos` no esté vacía | | `videos` | string[] | Hasta 3 URL de vídeos de referencia; cada vídeo debe durar 2-15 segundos, con una duración total máxima de 15 segundos | | `audios` | string[] | Hasta 3 URL de audios de referencia; cada clip debe durar 2-15 segundos, con un total máximo de 15 segundos; WAV o MP3, máximo 15 MB por clip; requiere al menos una imagen o un vídeo | #### Marcadores de referencia @ (AT) La función @ (AT) vincula los medios de referencia al prompt mediante marcadores numerados `<<<...>>>`. La numeración empieza en `1` de forma independiente para cada tipo de medio y sigue el orden de la matriz correspondiente: | Marcador | Valor referenciado | |-------------|------------------| | `<<>>` | `images[0]` | | `<<>>` | `images[1]` | | `<<>>` | `videos[0]` | | `<<>>` | `audios[0]` | Por ejemplo, si la primera imagen es una referencia de personaje y la segunda una de escena, utiliza `<<>>` para el personaje y `<<>>` para la escena en `prompt`. Cada marcador debe apuntar a un elemento existente en su matriz. #### Opcionales | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `sound` | boolean | Indica si se genera sonido sincronizado. Valor predeterminado: `true` | ### Ejemplo de solicitud ```javascript { model_name: 'seedance-v2.0-reference-to-video', prompt: 'Use image one for the subject, video one for the movement, and audio one for the atmosphere', duration: 8, resolution: '1080p', aspect_ratio: '16:9', sound: true, images: ['https://example.com/subject-reference.jpg'], videos: ['https://example.com/motion-reference.mp4'], audios: ['https://example.com/atmosphere-reference.mp3'] } ``` ### Ejemplo de solicitud Referencias a vídeo con @ (AT) ```javascript { model_name: 'seedance-v2.0-reference-to-video', prompt: 'Place the explorer from <<>> in the environment from <<>>, following the camera movement in <<>> and speaking with the reference voice from <<>>', duration: 8, resolution: '1080p', aspect_ratio: '16:9', sound: true, images: [ 'https://example.com/explorer-reference.jpg', 'https://example.com/environment-reference.jpg' ], videos: ['https://example.com/camera-movement-reference.mp4'], audios: ['https://example.com/voice-reference.mp3'] } ``` ## Variantes Fast Las variantes Fast priorizan la velocidad de procesamiento. Todos los modelos Fast solo admiten salida en `"480p"` y `"720p"`. Las demás estructuras de solicitud de Fast Texto a vídeo y Fast Imagen a vídeo coinciden con las de sus modelos estándar correspondientes, mientras que Fast Referencias a vídeo utiliza los mismos límites de medios de referencia que el modelo estándar. ### Ejemplo de solicitud Fast ```javascript { model_name: 'seedance-v2.0-fast-reference-to-video', prompt: 'Use image one for the subject, follow the movement from video one, and use audio one for the atmosphere', duration: 8, resolution: '720p', aspect_ratio: '9:16', sound: true, images: ['https://example.com/subject-reference.jpg'], videos: ['https://example.com/motion-reference.mp4'], audios: ['https://example.com/atmosphere-reference.mp3'] } ``` ### Ejemplo de solicitud Fast Referencias a vídeo con @ (AT) ```javascript { model_name: 'seedance-v2.0-fast-reference-to-video', prompt: 'Have the dancer from <<>> perform the movement from <<>> on the stage in <<>>, using the rhythm from <<>>', duration: 8, resolution: '720p', aspect_ratio: '9:16', sound: true, images: [ 'https://example.com/dancer-reference.jpg', 'https://example.com/stage-reference.jpg' ], videos: ['https://example.com/dance-movement-reference.mp4'], audios: ['https://example.com/rhythm-reference.mp3'] } ``` ### Parámetros de Seedance 2.0 Fast Referencias a vídeo #### Obligatorios | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `model_name` | string | Debe ser `"seedance-v2.0-fast-reference-to-video"` | | `prompt` | string | Prompt de generación de vídeo. Escribe un prompt estándar sin marcadores o utiliza opcionalmente la función de referencia @ (AT) con `<<>>`, `<<>>` y `<<>>` para referenciar explícitamente los elementos de las matrices de medios correspondientes | | `duration` | integer | Duración del vídeo en segundos enteros (4-15), en incrementos de 1 | | `resolution` | string | Resolución de salida: `"480p"` o `"720p"` | | `aspect_ratio` | string | Relación de aspecto del vídeo: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` o `"3:4"` | #### Medios de referencia | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `images` | string[] | 1-9 URL de imágenes de referencia, o una matriz vacía cuando `videos` no esté vacía | | `videos` | string[] | Hasta 3 URL de vídeos de referencia; cada vídeo debe durar 2-15 segundos, con una duración total máxima de 15 segundos | | `audios` | string[] | Hasta 3 URL de audios de referencia; cada clip debe durar 2-15 segundos, con un total máximo de 15 segundos; WAV o MP3, máximo 15 MB por clip; requiere al menos una imagen o un vídeo | La misma convención de marcadores que empiezan en 1 también se aplica al modelo Fast Referencias a vídeo. #### Opcionales | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `sound` | boolean | Indica si se genera sonido sincronizado. Valor predeterminado: `true` | ## Límites de medios Estos límites se aplican a las imágenes del primer y último fotograma y a los medios de referencia de los modelos de esta página. | Medio | Formatos | Límites | |-------|---------|--------| | Imágenes | JPEG, PNG, WEBP, BMP, TIFF, GIF, HEIC, HEIF | Cada imagen debe ocupar menos de 30 MB; ancho y alto de 300-6000 px cada uno; relación ancho/alto de 0.4-2.5 | | Vídeos | MP4, MOV | Máximo 200 MB cada uno; ancho y alto de 300-6000 px cada uno; relación ancho/alto de 0.4-2.5; tasa de fotogramas de 24-60 FPS | | Audio | WAV, MP3 | Máximo 15 MB por archivo | | Cuerpo de la solicitud | — | Máximo 64 MB | El audio y el vídeo de referencia tienen cada uno un límite independiente de duración total de 15 segundos. Las cantidades son independientes: hasta 9 imágenes, 3 vídeos y 3 clips de audio. Añadir vídeos no reduce el número de imágenes permitido. Todos los modelos usan `720p` por defecto, pero se debe proporcionar `resolution`. El interruptor de sonido vale `true` por defecto; ni este ajuste ni el audio de referencia cambian el precio. Referencias a vídeo requiere al menos una imagen o un vídeo; no admite solicitudes solo con audio. Subir vídeos de referencia duplica el coste de generación, independientemente de su número o duración. ## Formato de respuesta ### Respuesta inicial Todos los modelos devuelven un `task_id` para consultar el estado: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "submitted" } } ``` ### Respuesta de consulta Consulta `GET /api/v1/video/{taskId}` para comprobar el estado: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "succeed", "task_status_msg": null, "task_result": { "credit": 0.2, "videos": [ { "url": "https://example.com/generated-video.mp4" } ] } } } ``` ### Valores de estado - `submitted`: tarea aceptada y pendiente de procesamiento - `processing`: generación de vídeo en curso - `succeed`: generación de vídeo completada - `failed`: error en la generación de vídeo ## Tiempo de procesamiento **Modelos estándar**: 3-8 minutos según la duración y la resolución. **Modelos Fast**: 1-4 minutos para la mayoría de las configuraciones. Consulta el estado cada 5-10 segundos. ## Buenas prácticas 1. **Elegir la variante adecuada**: usa modelos Fast para iterar y modelos estándar para el resultado final 2. **Describir claramente el movimiento**: incluye descripciones concretas de movimiento en los prompts 3. **Elegir la resolución**: todos los modelos estándar de Seedance 2.0 admiten `480p`, `720p`, `1080p` y `4k`; todos los Fast solo admiten `480p` y `720p` 4. **Ordenar las referencias**: organiza `images`, `videos` y `audios` deliberadamente y referencia sus elementos de forma coherente en el prompt 5. **Solicitudes solo con vídeo**: utiliza una matriz `images` vacía únicamente si proporcionas al menos un vídeo de referencia 6. **Duración de medios**: mantén cada audio y vídeo de referencia entre 2 y 15 segundos 7. **Uso del audio**: omite `sound` para usar su valor predeterminado `true`, o establécelo en `false` para desactivar el sonido generado