# Seedance 2.0 API Referência completa da API dos modelos de geração de vídeo Seedance 2.0 da ByteDance. ## Variantes de modelos Esta API oferece seis variantes: | Modelo | ID | Descrição | |-------|-----|-------------| | **Seedance 2.0 Text to Video** | `seedance-v2.0-text-to-video` | Geração de vídeo de alta qualidade a partir de texto | | **Seedance 2.0 Image to Video** | `seedance-v2.0-image-to-video` | Animação de imagens com controle de movimento | | **Seedance 2.0 Reference to Video** | `seedance-v2.0-reference-to-video` | Geração de vídeo guiada por vídeo de referência | | **Seedance 2.0 Fast Text to Video** | `seedance-v2.0-fast-text-to-video` | Geração de vídeo mais rápida a partir de texto | | **Seedance 2.0 Fast Image to Video** | `seedance-v2.0-fast-image-to-video` | Geração de vídeo mais rápida a partir de imagens | | **Seedance 2.0 Fast Reference to Video** | `seedance-v2.0-fast-reference-to-video` | Geração de vídeo guiada por referências mais rápida | ## Comparação rápida | Recurso | Modelos padrão | Modelos Fast | |---------|-----------------|-------------| | Qualidade | Maior qualidade | Otimizados para velocidade | | Tempo de processamento | 3-8 minutos | 1-4 minutos | | Faixa de duração | 4-15 segundos | 4-15 segundos | | Opções de resolução | 480p, 720p, 1080p, 4k | 480p, 720p | | Mídias de referência | Imagens, vídeos e áudios para Reference-to-Video | Imagens, vídeos e áudios para Fast Reference-to-Video | ### Proporções de tela compatíveis `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` ### Opções de resolução | Resolução | Descrição | |------------|-------------| | `480p` | Definição padrão, processamento mais rápido | | `720p` | Alta definição, equilíbrio entre qualidade e velocidade | | `1080p` | Full HD, disponível em todos os modelos padrão Seedance 2.0 | | `4k` | Ultra HD, disponível em todos os modelos padrão Seedance 2.0 | ## Seedance 2.0 Texto para vídeo ### Ponto de extremidade ``` POST /api/v1/video/task ``` ### Parâmetros da requisição #### Obrigatórios | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `model_name` | string | Deve ser `"seedance-v2.0-text-to-video"` | | `prompt` | string | Prompt de geração de vídeo | | `duration` | integer | Duração do vídeo em segundos inteiros (4-15), em incrementos de 1 | | `resolution` | string | Resolução de saída: `"480p"`, `"720p"`, `"1080p"` ou `"4k"` | | `aspect_ratio` | string | Proporção do vídeo: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` ou `"3:4"` | #### Opcionais | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `sound` | boolean | Define se o som será gerado. Padrão: `true`; não afeta o preço | ### 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.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 Imagem para vídeo ### Parâmetros da requisição #### Obrigatórios | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `model_name` | string | Deve ser `"seedance-v2.0-image-to-video"` | | `prompt` | string | Prompt de geração de vídeo | | `duration` | integer | Duração do vídeo em segundos inteiros (4-15), em incrementos de 1 | | `resolution` | string | Resolução de saída: `"480p"`, `"720p"`, `"1080p"` ou `"4k"` | | `aspect_ratio` | string | Proporção do vídeo: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` ou `"3:4"` | | `image_url` | string | Primeiro quadro do vídeo | #### Opcionais | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `image_end_url` | string | URL opcional da imagem do quadro final | | `sound` | boolean | Define se o som será gerado. Padrão: `true`; não afeta o preço | ### Exemplo de requisição ```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 Referências para vídeo ### Parâmetros da requisição #### Obrigatórios | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `model_name` | string | Deve ser `"seedance-v2.0-reference-to-video"` | | `prompt` | string | Prompt de geração de vídeo. Escreva um prompt padrão sem marcadores ou use opcionalmente o recurso de referência @ (AT) com `<<>>`, `<<>>` e `<<>>` para referenciar explicitamente itens dos arrays de mídia correspondentes | | `duration` | integer | Duração do vídeo em segundos inteiros (4-15), em incrementos de 1 | | `resolution` | string | Resolução de saída: `"480p"`, `"720p"`, `"1080p"` ou `"4k"` | | `aspect_ratio` | string | Proporção do vídeo: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` ou `"3:4"` | #### Mídias de referência Envie 1-9 imagens. As imagens só podem ser omitidas quando pelo menos um vídeo de referência for fornecido. | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `images` | string[] | 1-9 URLs de imagens de referência, ou um array vazio quando `videos` não estiver vazio | | `videos` | string[] | Até 3 URLs de vídeos de referência; cada vídeo deve ter 2-15 segundos, com duração total de no máximo 15 segundos | | `audios` | string[] | Até 3 URLs de áudios de referência; cada clipe deve ter 2-15 segundos, com duração total de no máximo 15 segundos; WAV ou MP3, até 15 MB por clipe; exige pelo menos uma imagem ou um vídeo | #### Marcadores de referência @ (AT) O recurso @ (AT) vincula as mídias de referência ao prompt por marcadores numerados `<<<...>>>`. A numeração começa em `1` de forma independente para cada tipo de mídia e segue a ordem do array correspondente: | Marcador | Valor referenciado | |-------------|------------------| | `<<>>` | `images[0]` | | `<<>>` | `images[1]` | | `<<>>` | `videos[0]` | | `<<>>` | `audios[0]` | Por exemplo, se a primeira imagem é uma referência de personagem e a segunda de 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 | |-----------|------|-------------| | `sound` | boolean | Define se será gerado som sincronizado. Padrão: `true` | ### Exemplo de requisição ```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'] } ``` ### Exemplo de requisição Referências para vídeo com @ (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 As variantes Fast priorizam a velocidade de processamento. Todos os modelos Fast aceitam saída apenas em `"480p"` e `"720p"`. Fast Texto para vídeo e Fast Imagem para vídeo seguem, nos demais aspectos, as estruturas de requisição dos modelos padrão correspondentes, enquanto Fast Referências para vídeo usa os mesmos limites de mídia de referência do modelo padrão. ### Exemplo de requisição 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'] } ``` ### Exemplo de requisição Fast Referências para vídeo com @ (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 Referências para vídeo #### Obrigatórios | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `model_name` | string | Deve ser `"seedance-v2.0-fast-reference-to-video"` | | `prompt` | string | Prompt de geração de vídeo. Escreva um prompt padrão sem marcadores ou use opcionalmente o recurso de referência @ (AT) com `<<>>`, `<<>>` e `<<>>` para referenciar explicitamente itens dos arrays de mídia correspondentes | | `duration` | integer | Duração do vídeo em segundos inteiros (4-15), em incrementos de 1 | | `resolution` | string | Resolução de saída: `"480p"` ou `"720p"` | | `aspect_ratio` | string | Proporção do vídeo: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` ou `"3:4"` | #### Mídias de referência | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `images` | string[] | 1-9 URLs de imagens de referência, ou um array vazio quando `videos` não estiver vazio | | `videos` | string[] | Até 3 URLs de vídeos de referência; cada vídeo deve ter 2-15 segundos, com duração total de no máximo 15 segundos | | `audios` | string[] | Até 3 URLs de áudios de referência; cada clipe deve ter 2-15 segundos, com duração total de no máximo 15 segundos; WAV ou MP3, até 15 MB por clipe; exige pelo menos uma imagem ou um vídeo | A mesma convenção de marcadores iniciados em 1 se aplica ao modelo Fast Referências para vídeo. #### Opcionais | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `sound` | boolean | Define se será gerado som sincronizado. Padrão: `true` | ## Limites de mídia Estes limites se aplicam às imagens dos quadros inicial e final 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 | Cada imagem deve ter menos de 30 MB; largura e altura devem ser de 300-6000 px cada; proporção largura/altura de 0.4-2.5 | | Vídeos | MP4, MOV | Até 200 MB cada; largura e altura de 300-6000 px cada; proporção largura/altura de 0.4-2.5; taxa de quadros de 24-60 FPS | | Áudio | WAV, MP3 | Até 15 MB cada | | Corpo da requisição | — | Até 64 MB | Áudios e vídeos de referência têm, cada um, um limite independente de duração total de 15 segundos. As quantidades são independentes: até 9 imagens, 3 vídeos e 3 clipes de áudio. Adicionar vídeos não reduz a quantidade permitida de imagens. Todos os modelos usam `720p` por padrão, mas `resolution` continua obrigatório. O controle de som tem valor padrão `true`; nem esse controle nem o áudio de referência alteram o preço. Referências para vídeo exige pelo menos uma imagem ou um vídeo; requisições apenas com áudio não são aceitas. Enviar vídeos de referência dobra a cobrança da geração, independentemente da quantidade ou duração. ## Formato da resposta ### Resposta inicial Todos os modelos retornam um `task_id` para consulta periódica: ```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 da consulta Consulte `GET /api/v1/video/{taskId}` 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 de vídeo em andamento - `succeed`: geração de vídeo concluída - `failed`: falha na geração de vídeo ## Tempo de processamento **Modelos padrão**: 3-8 minutos, conforme a duração e a resolução. **Modelos Fast**: 1-4 minutos para a maioria das configurações. Consulte o status a cada 5-10 segundos. ## Boas práticas 1. **Escolha a variante adequada**: use modelos Fast para iterações e modelos padrão para a saída final 2. **Descreva claramente o movimento**: inclua descrições específicas de movimento nos prompts 3. **Seleção da resolução**: todos os modelos padrão Seedance 2.0 aceitam `480p`, `720p`, `1080p` e `4k`; todos os Fast aceitam apenas `480p` e `720p` 4. **Ordem das referências**: mantenha `images`, `videos` e `audios` em uma ordem intencional e faça referências consistentes no prompt 5. **Requisições apenas com vídeo**: use um array `images` vazio somente quando pelo menos um vídeo de referência for fornecido 6. **Duração da mídia**: mantenha cada áudio e vídeo de referência entre 2 e 15 segundos 7. **Uso do áudio**: omita `sound` para usar o padrão `true`, ou defina como `false` para desativar o som gerado