# Seedance 2.5 Flash API Referência completa da API dos modelos de geração de vídeo Seedance 2.5 Flash da ByteDance. ## Variantes do modelo Esta API oferece três variantes: | Modelo | ID | Descrição | |-------|----|-------------| | **Seedance 2.5 Flash Text to Video** | `seedance-v2.5-flash-text-to-video` | Geração de vídeo de alta qualidade a partir de texto | | **Seedance 2.5 Flash Image to Video** | `seedance-v2.5-flash-image-to-video` | Geração de vídeo a partir do primeiro quadro ou do primeiro e do último quadro | | **Seedance 2.5 Flash Reference to Video** | `seedance-v2.5-flash-reference-to-video` | Geração de vídeo orientada por imagens, vídeos e áudios de referência | ## Comparação rápida | Recurso | Texto para vídeo | Imagem para vídeo | Referências para vídeo | |---------|---------------|----------------|--------------------| | Duração | 4 a 30 segundos | 4 a 30 segundos | 4 a 30 segundos | | Opções de resolução | 480p, 720p | 480p, 720p | 480p, 720p | | Proporção | Opcional (padrão: 16:9) | Sem suporte | Opcional (padrão: 16:9) | | Mídia obrigatória | Nenhuma | Imagem do primeiro quadro | Nenhuma | | Mídia opcional | Nenhuma | Imagem do último quadro | Imagens, vídeos e áudios | ### Proporções compatíveis As variantes de texto para vídeo e de referências para vídeo aceitam as seguintes proporções: `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` A variante de imagem para vídeo não aceita o parâmetro `aspect_ratio`. ### Opções de resolução | Resolução | Descrição | |------------|-------------| | `480p` | Definição padrão | | `720p` | Alta definição | ## Seedance 2.5 Flash Text to Video ### Endpoint ``` POST /api/v1/video/task ``` ### Parâmetros da requisição #### Obrigatórios | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `model_name` | string | Deve ser `"seedance-v2.5-flash-text-to-video"` | | `prompt` | string | Prompt para gerar o vídeo, com até 5000 caracteres | | `resolution` | string | Resolução de saída: `"480p"` ou `"720p"`. Sem valor padrão | | `duration` | integer | Duração do vídeo em segundos inteiros, de 4 a 30, em incrementos de 1. Sem valor padrão | #### Opcionais | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `aspect_ratio` | string | Proporção do vídeo: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` ou `"3:4"`. O padrão é `"16:9"` | | `sound` | boolean | Indica se o vídeo deve ter som. O padrão é `true`. Use `false` para gerar um vídeo sem som | ### Exemplo de requisição ```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 da requisição #### Obrigatórios | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `model_name` | string | Deve ser `"seedance-v2.5-flash-image-to-video"` | | `prompt` | string | Prompt para gerar o vídeo, com até 5000 caracteres | | `resolution` | string | Resolução de saída: `"480p"` ou `"720p"`. Sem valor padrão | | `duration` | integer | Duração do vídeo em segundos inteiros, de 4 a 30, em incrementos de 1. Sem valor padrão | | `image_url` | string | URL da imagem do primeiro quadro. Consulte os limites de mídia abaixo. O vídeo gerado usa a proporção dessa imagem | #### Opcionais | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `image_end_url` | string | URL opcional da imagem do último quadro. Consulte os limites de mídia abaixo. Recomenda-se usar a mesma proporção do primeiro quadro | | `sound` | boolean | Indica se o vídeo deve ter som. O padrão é `true`. Use `false` para gerar um vídeo sem som | > Omita `aspect_ratio` nas requisições de imagem para vídeo. O modelo não aceita esse parâmetro. ### Exemplo de requisição ```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 da requisição #### Obrigatórios | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `model_name` | string | Deve ser `"seedance-v2.5-flash-reference-to-video"` | | `prompt` | string | Prompt para gerar o vídeo, com até 5000 caracteres. Escreva um prompt comum sem marcadores ou use o recurso de referência @ (AT) com `<<>>`, `<<>>` e `<<>>` para indicar explicitamente os itens dos respectivos arrays de mídia | | `resolution` | string | Resolução de saída: `"480p"` ou `"720p"`. Sem valor padrão | | `duration` | integer | Duração do vídeo em segundos inteiros, de 4 a 30, em incrementos de 1. Sem valor padrão | #### Mídias de referência Todas as mídias de referência são opcionais. É possível enviar apenas imagens, apenas vídeos, apenas áudios ou nenhuma referência. Para gerar vídeos sem referências, recomenda-se a variante de texto para vídeo. | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `images` | string[] | De 0 a 10 URLs de imagens de referência, identificadas na ordem do array. Consulte os limites de mídia abaixo | | `videos` | string[] | De 0 a 5 URLs de vídeos de referência em MP4 ou MOV. Cada vídeo deve durar de 2 a 30 segundos, e a soma das durações não pode ultrapassar 30 segundos. Consulte os limites de mídia abaixo. Para a cobrança, a duração total dos vídeos de referência é arredondada para o segundo mais próximo (meio segundo é arredondado para cima) e somada à duração do vídeo gerado | | `audios` | string[] | De 0 a 5 URLs de áudios de referência em WAV ou MP3. Cada áudio deve durar de 2 a 30 segundos e ter no máximo 15 MB. A soma das durações não pode ultrapassar 30 segundos | #### Marcadores de referência @ (AT) O recurso de referência @ (AT) associa as mídias ao prompt por meio de marcadores numerados `<<<...>>>`. A numeração começa em `1` para cada tipo de mídia e segue a ordem do respectivo array: | Marcador | Valor referenciado | |-------------|------------------| | `<<>>` | `images[0]` | | `<<>>` | `images[1]` | | `<<>>` | `videos[0]` | | `<<>>` | `audios[0]` | Por exemplo, se a primeira imagem servir de referência para um personagem e a segunda para o cenário, use `<<>>` para o personagem e `<<>>` para o cenário em `prompt`. Cada marcador deve apontar para um item existente no array correspondente. #### Opcionais | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `aspect_ratio` | string | Proporção do vídeo: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` ou `"3:4"`. O padrão é `"16:9"` | | `sound` | boolean | Indica se o vídeo deve ter som. O padrão é `true`. Use `false` para gerar um vídeo sem som | ### Exemplo de requisição ```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'] } ``` ### Exemplo de requisição de referências para vídeo com @ (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'] } ``` ## Limites de mídia Estes limites se aplicam às imagens do primeiro e do último quadro e às mídias de referência dos modelos desta página. | Mídia | Formatos | Limites | |-------|---------|--------| | Imagens | JPEG, PNG, WEBP, BMP, TIFF, GIF, HEIC, HEIF | Menos de 30 MB por imagem. Tanto a largura quanto a altura devem estar entre 300 e 6000 px. A razão entre largura e altura deve estar entre 0,4 e 2,5 | | Vídeos | MP4, MOV | Até 200 MB por vídeo. Tanto a largura quanto a altura devem estar entre 300 e 6000 px, com razão entre largura e altura de 0,4 a 2,5, taxa de quadros de 24 a 60 FPS e total de 407696 a 8295044 pixels | | Áudio | WAV, MP3 | Até 15 MB por arquivo | As durações totais dos áudios e dos vídeos de referência têm limites separados de 30 segundos. As quantidades também são independentes: até 10 imagens, 5 vídeos e 5 clipes de áudio. Todos os modelos exigem `resolution` e `duration`, sem valores padrão. As variantes de texto para vídeo e de referências para vídeo usam `16:9` quando `aspect_ratio` é omitido. O som vem ativado por padrão (`true`). Use `false` para gerar um vídeo sem som. ## Formato da resposta ### Resposta inicial Todos os modelos retornam um `task_id` para consultas periódicas de status: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "submitted" } } ``` ### Resposta à consulta de status Consulte `GET /api/v1/video/{taskId}` periodicamente para verificar o status: ```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 status - `submitted`: Tarefa aceita e aguardando processamento - `processing`: Geração do vídeo em andamento - `succeed`: Geração do vídeo concluída - `failed`: Falha na geração do vídeo ## Tempo de processamento O tempo de processamento varia conforme a duração, a resolução e as condições atuais da fila. Consulte o status a cada 5 a 10 segundos. ## Boas práticas 1. **Parâmetros obrigatórios**: sempre informe `prompt`, `resolution` e `duration`. Nas variantes de texto para vídeo e de referências para vídeo, `aspect_ratio` é opcional e o padrão é `16:9` 2. **Proporção na geração a partir de imagem**: omita `aspect_ratio` nas requisições de imagem para vídeo 3. **Vídeos de referência**: os vídeos são opcionais. Respeite os limites de duração de cada vídeo e da soma de todos eles 4. **Imagens de referência**: as imagens são opcionais, independentemente dos vídeos e áudios. Envie até 10 URLs de imagens compatíveis 5. **Áudios de referência**: cada clipe deve durar de 2 a 30 segundos e ter até 15 MB. A duração total não pode ultrapassar 30 segundos 6. **Ordem das referências**: organize `images`, `videos` e `audios` na ordem desejada e faça referência aos itens no prompt seguindo essa ordem 7. **Som**: omita `sound` para usar o valor padrão `true` ou defina-o como `false` para desativar a geração de som