doubao-seedance-2-0
doubao-seedance-2.0 — Geração de vídeo
- Modo de processamento assíncrono, retorna um ID de tarefa para consultas posteriores
- Suporta texto-para-vídeo e imagem-para-vídeo (primeiro frame/último frame)
- Suporta vídeo de referência, áudio de referência e vídeo com áudio
- Suporta proporções paisagem, retrato, quadrada, ultrawide e adaptativa
POST
Documentation Index
Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
Use this file to discover all available pages before exploring further.
Autenticação
Todos os endpoints da API exigem autenticação via Bearer TokenObtenha sua API Key:Acesse a página de gerenciamento de API Keys para obter sua API KeyAdicione-a ao cabeçalho da requisição:
Parâmetros da requisição
Nome do modelo de geração de vídeoModelos suportados:
doubao-seedance-2.0— versão padrão, suporta texto-para-vídeo, imagem-para-vídeo, vídeo com primeiro/último frame, vídeo de referência, áudio de referência e vídeo com áudiodoubao-seedance-2.0-fast— versão rápida, com os mesmos recursos da versão padrão e maior velocidade de geraçãodoubao-seedance-2.0-face— suporta upload de pessoa real, com os mesmos recursos da versão padrãodoubao-seedance-2.0-fast-face— suporta upload de pessoa real, com os mesmos recursos da versão rápida
Descrição do conteúdo do vídeoObrigatório para texto-para-vídeo; opcional para imagem-para-vídeo ou vídeo a partir de vídeo de referênciaRecomenda-se especificar claramente o sujeito, a ação, o movimento de câmera e o estilo para obter melhores resultados de geraçãoExemplo:
"A kitten yawning at the camera"Duração do vídeo (segundos)Faixa suportada:
4 a 15 segundosPadrão: 5Proporção do vídeoOpções:
16:9— paisagem9:16— retrato1:1— quadrado4:3— proporção tradicional3:4— proporção tradicional vertical21:9— ultrawideadaptive— adaptativa (corresponde automaticamente à imagem/vídeo de entrada)
16:9Resolução do vídeoOpções:
480p— definição padrão720p— alta definição1080p— Full HD (suportado apenas pordoubao-seedance-2.0-faceedoubao-seedance-2.0)
480pSeed aleatória para controlar a aleatoriedade do conteúdo gerado
- Para a mesma requisição, valores de seed diferentes produzirão resultados diferentes
- Para a mesma requisição, o mesmo valor de seed produzirá resultados semelhantes, mas não há garantia de consistência exata
Se deve gerar áudio (vídeo com áudio)Quando definido como
true, o vídeo incluirá áudio gerado por IA acompanhando-oPadrão: falseSe deve retornar a imagem do último frameQuando definido como
true, o resultado da tarefa retornará adicionalmente a URL da imagem do último frame do vídeo, que pode ser usada para geração contínua de vídeoPadrão: falseLista de ferramentas para recursos adicionais, como busca na webExemplo:
[{"type": "web_search"}]Array de URLs de imagem para imagem-para-vídeoSuporta dois formatos:
- URL de imagem comum:
https://example.com/cat.jpg - Asset URL (asset aprovado):
asset://asset_a
["https://example.com/cat.jpg"] ou ["asset://asset_a"]Asset URL é suportado apenas pelos modelos
doubao-seedance-2.0 e doubao-seedance-2.0-fast. Outros modelos não o suportam.Array de imagens com papéis, permite especificar primeiro frame/último frameExemplo:Formato Asset URL:
Quando o campo
url usa uma Asset URL, apenas os modelos doubao-seedance-2.0 e doubao-seedance-2.0-fast são suportados. Outros modelos não o suportam.Array de URLs de vídeo de referênciaSuporta dois formatos:
- URL de vídeo comum:
https://example.com/reference.mp4 - Asset URL (asset aprovado):
asset://asset_a
["https://example.com/reference.mp4"] ou ["asset://asset_a"]Asset URL é suportado apenas pelos modelos
doubao-seedance-2.0 e doubao-seedance-2.0-fast. Outros modelos não o suportam.Array de URLs de áudio de referênciaSuporta dois formatos:
- URL de áudio comum:
https://example.com/speech.wav - Asset URL (asset aprovado):
asset://asset_a
["https://example.com/speech.wav"] ou ["asset://asset_a"]Asset URL é suportado apenas pelos modelos
doubao-seedance-2.0 e doubao-seedance-2.0-fast. Outros modelos não o suportam.Resposta
Código de status da resposta, 200 em caso de sucesso
Array de dados da resposta
Casos de uso
Caso 1: Texto-para-vídeo
Caso 2: Imagem-para-vídeo (primeiro frame)
Caso 3: Vídeo com primeiro/último frame
Caso 4: Vídeo a partir de vídeo de referência
Caso 5: Vídeo de referência + áudio de referência
Caso 6: Vídeo com áudio
Caso 7: Geração contínua de vídeo (retornar último frame)
Caso 8: Geração com a versão rápida
Caso 9: Imagens de referência + vídeo de referência + áudio de referência (vídeo multimodal)
Combine imagens de referência, vídeo de referência e áudio de referência para gerar um vídeo publicitário imersivo em perspectiva em primeira pessoa. Ideal para divulgação de produtos, anúncios de marca e outros cenários que exigem a fusão de múltiplas fontes de material.Caso 10: Imagem-para-vídeo com Asset URL
Assets de avatar virtual aprovados podem ser passados diretamente como imagens de referência, sem necessidade de novo upload ou nova revisão.Caso 11: Especificar retrato de referência com Asset URL (image_with_roles)
Caso 12: Versão rápida + Asset URL imagem-para-vídeo
Caso 13: Imagem com Asset URL + vídeo de referência (transferência de movimento)
Combine um asset de retrato aprovado com um vídeo de referência para fazer o personagem executar os movimentos especificados.Consultar resultados da tarefaA geração de vídeo é uma tarefa assíncrona que retorna um
task_id ao ser enviada. Use o endpoint Obter status da tarefa para consultar o progresso e os resultados da geração.Diferenças em relação à versão 1.5 Pro
| Recurso | 1.5 Pro | 2.0 / 2.0 fast |
|---|---|---|
| Resolução | 480p/720p/1080p | 480p/720p |
| Faixa de duração | 4-12s | 5-15s |
| Duração padrão | 5s | 5s |
| Parâmetro de proporção | aspect_ratio | size (nova opção adaptive) |
| Geração de áudio | parâmetro audio | parâmetro generate_audio |
| Vídeo de referência | Não suportado | Suportado via video_urls |
| Áudio de referência | Não suportado | Suportado via audio_urls |
| Imagem-para-vídeo | image_urls / image_with_roles | image_urls / image_with_roles |
| Vídeo com áudio | Não suportado | Suportado via generate_audio |
| Vídeo contínuo | Não suportado | Suportado via return_last_frame |
| Versão rápida | Não suportado | Suportado via doubao-seedance-2.0-fast |