Skip to main content
POST

Autenticação

string
obrigatório
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

string
obrigatório
Nome do modelo de geração de vídeoModelos suportados:
  • 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 áudio
  • seedance-2.0-fast — versão rápida, com os mesmos recursos da versão padrão e maior velocidade de geração
  • seedance-2.0-mini — versão mini, com os mesmos recursos da versão padrão
boolean
padrão:"false"
Define se o conteúdo deve ser moderado antes do envio da tarefa de vídeo.
  • true: verificar prompts e imagens de entrada com omni-moderation-latest
  • false ou omitido: não enviar solicitação de moderação, sem custo nem latência adicionais de moderação (padrão)
Conteúdo verificado:
  • Texto: prompt, negative_prompt
  • Imagens: image_urls, image_with_roles[].url, first_frame_image, last_frame_image
  • Assets privados de imagem asset://: resolver e verificar a URL pública original
  • Imagens Base64: verificar após a conversão para uma URL pública
video_urls, audio_urls e assets privados de vídeo/áudio não são verificados, pois o modelo de moderação não aceita vídeo nem áudio.IDs de modelo compatíveis: seedance-2.0, seedance-2.0-fast, seedance-2.0-mini, seedance-2.0-face, seedance-2.0-fast-face, seedance-2-0 (nome antigo) e seedance-2.5.A chamada de moderação não é cobrada do usuário que envia a solicitação de vídeo.
  • Conteúdo detectado retorna HTTP 400 (nsfw_content_detected) de forma síncrona. Nenhuma tarefa ou task_id é criada e nenhuma cota de geração de vídeo é descontada
  • Se a moderação estiver indisponível, expirar ou retornar uma resposta inválida, o comportamento será fail-open e a geração continuará. Esta opção não é uma garantia absoluta de segurança do conteúdo
  • Entradas que não possam ser resolvidas para uma URL pública de imagem serão ignoradas; modelos não compatíveis ignoram silenciosamente nsfw_check: true
Exemplo:
Resposta quando detectado:
string
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ção
  • O prompt é limitado a 4000 caracteres, mas o recomendado são 500 caracteres.
  • O modelo seedance-2.0-mini não tem limite de caracteres. Recomendação: os prompts em chinês não devem ultrapassar 500 caracteres e os prompts em inglês não devem ultrapassar 1000 palavras. Texto em excesso tende a dispersar as informações, e o modelo pode ignorar detalhes e focar apenas nos pontos principais, fazendo com que faltem alguns elementos no vídeo.
Exemplo: "A kitten yawning at the camera"
integer
padrão:"5"
Duração do vídeo (segundos)Faixa suportada: 4 a 15 segundosPadrão: 5
string
padrão:"16:9"
Proporção do vídeoA proporção deve estar entre 0.5 e 2.5Opções:
  • 16:9 — paisagem
  • 9:16 — retrato
  • 1:1 — quadrado
  • 4:3 — proporção tradicional
  • 3:4 — proporção tradicional vertical
  • 21:9 — ultrawide
  • adaptive — adaptativa (corresponde automaticamente à imagem/vídeo de entrada)
Padrão: 16:9
string
padrão:"720p"
Resolução do vídeoOpções:
  • 480p — definição padrão
  • 720p — alta definição
  • 1080p — Full HD (suportado apenas por seedance-2.0)
  • 4k — Ultra HD (suportado apenas por seedance-2.0)
Padrão: 720p
integer
Seed 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
boolean
padrão:"true"
Se deve gerar áudio (vídeo com áudio)Quando definido como true, o vídeo incluirá áudio gerado por IA acompanhando-oQuando definido como false, o vídeo não incluirá áudio (vídeo sem som)Padrão: true
boolean
padrão:"false"
Se 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: false
array<object>
Lista de ferramentas para recursos adicionais, como busca na webExemplo: [{"type": "web_search"}]
array<string>
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
Exemplo: ["https://example.com/cat.jpg"] ou ["asset://asset_a"]
Asset URLs são compatíveis com todos os modelos Seedance 2.0: seedance-2.0, seedance-2.0-fast e seedance-2.0-mini.
  • image_urls e image_with_roles não podem ser usados simultaneamente
  • Máximo de 9 imagens de referência
array
Array de imagens com papéis, permite especificar primeiro frame/último frame
Quando o campo url usa uma Asset URL, todos os modelos Seedance 2.0 são compatíveis: seedance-2.0, seedance-2.0-fast e seedance-2.0-mini.
Exemplo:
Formato Asset URL:
  • image_urls e image_with_roles não podem ser usados simultaneamente
  • Ao usar imagens de primeiro/último frame, video_urls e audio_urls não estão disponíveis
array<string>
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
Exemplo: ["https://example.com/reference.mp4"] ou ["asset://asset_a"]
Asset URLs são compatíveis com todos os modelos Seedance 2.0: seedance-2.0, seedance-2.0-fast e seedance-2.0-mini.
  • Ao usar imagens de primeiro/último frame (image_with_roles), vídeos de referência não estão disponíveis
  • Máximo de 3 vídeos de referência, 1.8s < duração total < 15.2s
  • A resolução do vídeo de referência deve estar entre 480P e 720P
array<string>
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
Exemplo: ["https://example.com/speech.wav"] ou ["asset://asset_a"]
Asset URLs são compatíveis com todos os modelos Seedance 2.0: seedance-2.0, seedance-2.0-fast e seedance-2.0-mini.
  • Ao usar imagens de primeiro/último frame (image_with_roles), áudio de referência não está disponível
  • Máximo de 3 arquivos de áudio de referência, com duração total de até 15s
  • O áudio de referência deve ser usado junto com imagens de referência ou vídeos de referência

Resposta

integer
Código de status da resposta, 200 em caso de sucesso
array
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