# Seedance 2.5 Flash API Referencia completa de la API de los modelos de generación de vídeo Seedance 2.5 Flash de ByteDance. ## Variantes del modelo Esta API admite tres variantes del modelo: | Modelo | ID | Descripción | |-------|----|-------------| | **Seedance 2.5 Flash Text to Video** | `seedance-v2.5-flash-text-to-video` | Generación de vídeos de alta calidad a partir de texto | | **Seedance 2.5 Flash Image to Video** | `seedance-v2.5-flash-image-to-video` | Generación de vídeo a partir del primer fotograma o del primero y el último | | **Seedance 2.5 Flash Reference to Video** | `seedance-v2.5-flash-reference-to-video` | Generación de vídeo guiada por imágenes, vídeos y audio de referencia | ## Comparación rápida | Característica | De texto a vídeo | De imagen a vídeo | De referencias a vídeo | |---------|---------------|----------------|--------------------| | Duración | De 4 a 30 segundos | De 4 a 30 segundos | De 4 a 30 segundos | | Resoluciones disponibles | 480p, 720p | 480p, 720p | 480p, 720p | | Relación de aspecto | Opcional (predeterminada: 16:9) | No se admite | Opcional (predeterminada: 16:9) | | Medios obligatorios | Ninguno | Imagen del primer fotograma | Ninguno | | Medios opcionales | Ninguno | Imagen del último fotograma | Imágenes, vídeos y audio | ### Relaciones de aspecto admitidas Las variantes de generación a partir de texto y de referencias admiten las siguientes relaciones de aspecto: `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` La variante de generación a partir de una imagen no admite el parámetro `aspect_ratio`. ### Resoluciones disponibles | Resolución | Descripción | |------------|-------------| | `480p` | Definición estándar | | `720p` | Alta definición | ## Seedance 2.5 Flash Text to Video ### Punto de conexión ``` POST /api/v1/video/task ``` ### Parámetros de la solicitud #### Obligatorios | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `model_name` | string | Debe ser `"seedance-v2.5-flash-text-to-video"` | | `prompt` | string | Instrucción para generar el vídeo, de hasta 5000 caracteres | | `resolution` | string | Resolución de salida: `"480p"` o `"720p"`. Sin valor predeterminado | | `duration` | integer | Duración del vídeo en segundos enteros, de 4 a 30 en incrementos de 1. Sin valor predeterminado | #### Opcionales | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `aspect_ratio` | string | Relación de aspecto del vídeo: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` o `"3:4"`. El valor predeterminado es `"16:9"` | | `sound` | boolean | Indica si se debe generar sonido. El valor predeterminado es `true`. Con `false` se genera un vídeo sin sonido | ### 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.5-flash-text-to-video', prompt: 'A golden retriever running through a sunlit meadow', resolution: '720p', duration: 8, aspect_ratio: '16:9', sound: true }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Seedance 2.5 Flash Image to Video ### Parámetros de la solicitud #### Obligatorios | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `model_name` | string | Debe ser `"seedance-v2.5-flash-image-to-video"` | | `prompt` | string | Instrucción para generar el vídeo, de hasta 5000 caracteres | | `resolution` | string | Resolución de salida: `"480p"` o `"720p"`. Sin valor predeterminado | | `duration` | integer | Duración del vídeo en segundos enteros, de 4 a 30 en incrementos de 1. Sin valor predeterminado | | `image_url` | string | URL de la imagen del primer fotograma. El vídeo generado adopta la relación de aspecto de esta imagen. Consulta la sección «Límites de los medios» más abajo | #### Opcionales | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `image_end_url` | string | URL opcional de la imagen del último fotograma. Se recomienda usar la misma relación de aspecto que en el primer fotograma. Consulta la sección «Límites de los medios» más abajo | | `sound` | boolean | Indica si se debe generar sonido. El valor predeterminado es `true`. Con `false` se genera un vídeo sin sonido | > No incluyas `aspect_ratio` en las solicitudes de generación de vídeo a partir de una imagen. Este modelo no admite ese parámetro. ### Ejemplo de solicitud ```javascript { model_name: 'seedance-v2.5-flash-image-to-video', image_url: 'https://example.com/first-frame.jpg', image_end_url: 'https://example.com/last-frame.jpg', prompt: 'Camera slowly pulls back to reveal the full landscape', resolution: '720p', duration: 8, sound: true } ``` ## Seedance 2.5 Flash Reference to Video ### Parámetros de la solicitud #### Obligatorios | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `model_name` | string | Debe ser `"seedance-v2.5-flash-reference-to-video"` | | `prompt` | string | Instrucción para generar el vídeo, de hasta 5000 caracteres. Escribe una instrucción normal sin marcadores o usa la función de referencias @ (AT) con `<<>>`, `<<>>` y `<<>>` para hacer referencia explícita a elementos de las listas de medios correspondientes | | `resolution` | string | Resolución de salida: `"480p"` o `"720p"`. Sin valor predeterminado | | `duration` | integer | Duración del vídeo en segundos enteros, de 4 a 30 en incrementos de 1. Sin valor predeterminado | #### Medios de referencia Todos los medios de referencia son opcionales. Se admiten solicitudes con solo imágenes, solo vídeos, solo audio o sin ningún medio de referencia. Para generar vídeos sin referencias se recomienda la variante Text to Video. | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `images` | string[] | De 0 a 10 URL de imágenes de referencia. Las referencias siguen el orden de la lista. Consulta «Límites de los medios» más abajo | | `videos` | string[] | De 0 a 5 URL de vídeos de referencia en formato MP4 o MOV. Cada vídeo debe durar entre 2 y 30 segundos, con una duración total máxima de 30 segundos. Consulta «Límites de los medios» más abajo. Para la facturación, la duración total de los vídeos de referencia se redondea al segundo más cercano (los medios segundos se redondean hacia arriba) y se suma a la duración del vídeo generado | | `audios` | string[] | De 0 a 5 URL de clips de audio de referencia en formato WAV o MP3. Cada clip debe durar entre 2 y 30 segundos y ocupar como máximo 15 MB. La duración total no debe superar los 30 segundos | #### Marcadores de referencia @ (AT) La función de referencias @ (AT) vincula los medios de referencia con la instrucción mediante marcadores numerados del tipo `<<<...>>>`. La numeración empieza en `1` para cada tipo de medio y sigue el orden de la lista correspondiente: | Marcador | Valor al que hace referencia | |-------------|------------------| | `<<>>` | `images[0]` | | `<<>>` | `images[1]` | | `<<>>` | `videos[0]` | | `<<>>` | `audios[0]` | Por ejemplo, si la primera imagen sirve de referencia para un personaje y la segunda para una escena, usa `<<>>` para el personaje y `<<>>` para la escena en `prompt`. Cada marcador debe apuntar a un elemento existente en la lista correspondiente. #### Opcionales | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `aspect_ratio` | string | Relación de aspecto del vídeo: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` o `"3:4"`. El valor predeterminado es `"16:9"` | | `sound` | boolean | Indica si se debe generar sonido. El valor predeterminado es `true`. Con `false` se genera un vídeo sin sonido | ### Ejemplo de solicitud ```javascript { model_name: 'seedance-v2.5-flash-reference-to-video', prompt: 'Use image one for the subject, video one for the movement, and audio one for the atmosphere', resolution: '720p', duration: 8, 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 de generación de vídeo con referencias @ (AT) ```javascript { model_name: 'seedance-v2.5-flash-reference-to-video', prompt: 'Place the explorer from <<>> in the environment from <<>>, following the camera movement in <<>> and speaking with the reference voice from <<>>', resolution: '720p', duration: 10, aspect_ratio: '16:9', sound: true, images: [ 'https://example.com/explorer-reference.jpg', 'https://example.com/environment-reference.png' ], videos: ['https://example.com/camera-movement-reference.mp4'], audios: ['https://example.com/voice-reference.mp3'] } ``` ## Límites de los medios Estos límites se aplican a las imágenes del primer y del último fotograma y a los medios de referencia de los modelos descritos en 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. Tanto la anchura como la altura deben estar entre 300 y 6000 px, y la relación entre anchura y altura debe estar entre 0,4 y 2,5 | | Vídeos | MP4, MOV | Máximo de 200 MB por vídeo. Tanto la anchura como la altura deben estar entre 300 y 6000 px, y la relación entre anchura y altura debe estar entre 0,4 y 2,5. La frecuencia debe ser de 24 a 60 fotogramas por segundo y el número total de píxeles debe estar entre 407696 y 8295044 | | Audio | WAV, MP3 | Máximo de 15 MB por archivo | Los clips de audio y los vídeos de referencia tienen límites de duración independientes de 30 segundos en total para cada tipo. Las cantidades máximas también son independientes: hasta 10 imágenes, 5 vídeos y 5 clips de audio. Todos los modelos requieren `resolution` y `duration`, sin valores predeterminados. Si se omite `aspect_ratio`, las variantes de generación a partir de texto y de referencias usan `16:9`. El sonido está activado de forma predeterminada (`true`). Usa `false` para generar un vídeo sin sonido. ## Formato de respuesta ### Respuesta inicial Todos los modelos devuelven un `task_id` para consultar periódicamente el estado de la tarea: ```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 a la consulta de estado 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 en espera de procesamiento - `processing`: Generación del vídeo en curso - `succeed`: Generación del vídeo completada - `failed`: Error en la generación del vídeo ## Tiempo de procesamiento El tiempo de procesamiento varía según la duración, la resolución y el estado de la cola. Consulta el estado cada 5 a 10 segundos. ## Prácticas recomendadas 1. **Parámetros obligatorios**: incluye siempre `prompt`, `resolution` y `duration`. Para la generación a partir de texto y de referencias, `aspect_ratio` es opcional y su valor predeterminado es `16:9` 2. **Relación de aspecto al generar vídeo a partir de una imagen**: no envíes `aspect_ratio` en estas solicitudes 3. **Vídeos de referencia**: los vídeos son opcionales. Tanto la duración de cada vídeo como la duración total deben respetar los límites indicados 4. **Imágenes de referencia**: las imágenes son opcionales con independencia de los vídeos y el audio. Puedes enviar hasta 10 URL de imágenes en formatos admitidos 5. **Audio de referencia**: cada clip debe durar entre 2 y 30 segundos y ocupar como máximo 15 MB, con una duración total máxima de 30 segundos 6. **Orden de las referencias**: coloca los elementos de `images`, `videos` y `audios` en el orden deseado y respeta ese orden cuando los menciones en la instrucción 7. **Sonido**: omite `sound` para usar su valor predeterminado `true` o asígnale `false` para desactivar la generación de sonido