Saltar para o conteúdo principal
POST
Envie com POST /v1/videos/generations, leia data[0].task_id e consulte GET /v1/tasks/{task_id}.
string
obrigatório
Use Authorization: Bearer <token>, onde <token> é sua chave de API APIMart.

Parâmetros da requisição

string
obrigatório
Use seedance-2-5-flash. O alias doubao-seedance-2-5-flash também é aceito. O nome com ponto seedance-2.5-flash não é compatível.
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)
Uma detecção retorna HTTP 400 (nsfw_content_detected) sem criar tarefa nem cobrar a geração. Vídeos e áudios de referência não são analisados. A requisição pode continuar se o serviço de moderação falhar.
string
obrigatório
Prompt obrigatório. Referencie mídias com @图片1 / @视频1 / @音频1; os índices começam em 1 e seguem a ordem de cada array de mídia.
string
padrão:"720p"
Somente 480p / 720p; padrão 720p. Valores como 1080p, 2k ou 4k retornam HTTP 400 no envio.
string
padrão:"adaptive"
Aceita 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive (padrão). Alias: aspect_ratio. Quadros inicial/final, edição e extensão exigem adaptive.
integer
Segundos inteiros 4–30; requisições comuns usam 5 quando omitido. -1 ativa duração automática. edit explícito só aceita -1 ou omissão, convertida em -1; a duração segue o vídeo de origem. A duração automática reserva 30 segundos e depois é liquidada pelos tokens reais.
boolean
padrão:"true"
Gerar som, padrão true. Alias: audio. Controla a saída, separadamente do áudio de referência audio_urls.
boolean
padrão:"false"
Adicionar marca d’água de geração por IA, padrão false.
integer
Semente aleatória opcional. A mesma semente não garante resultados idênticos.
string
padrão:"mp4"
Contêiner de saída: mp4 (padrão) ou mov.
string
padrão:"auto"
auto (padrão), reference, edit ou extend, apenas para tarefas com referências. Tipos explícitos ativam as verificações no envio descritas abaixo.
string[]
Array de imagens, todas tratadas como reference_image. No máximo 10 combinadas com image_with_roles. Use este último para os quadros inicial e final.
object[]
Cada item contém url e role. Funções: reference_image, first_frame (máximo 1), last_frame (máximo 1, junto ao inicial). Máximo 10 imagens com image_urls; evite funções conflitantes. Com video_urls / audio_urls, os quadros inicial/final tornam-se imagens de referência multimodal.
string[]
Até 5 vídeos, cada um com 2–30 segundos e no máximo 30 segundos no total. Vídeos de origem para edição devem ter 4–30 segundos.
string[]
Até 5 áudios, cada um com 2–30 segundos e no máximo 30 segundos no total. Referências somente de áudio são aceitas, sem imagem ou vídeo.
boolean
padrão:"false"
Com true, retorna uma imagem do último quadro após o sucesso em data.result.videos[].last_frame_url.
Permitir pesquisa na web conforme necessário, padrão false.
object[]
Lista opcional de ferramentas, por exemplo [{"type":"web_search"}] para pesquisa na web.
draft / draft_task_id não são compatíveis; remova-os ou o envio retornará HTTP 400. Para rascunhos, use Seedance 2.5.

Requisitos de mídia

Use URLs http(s) públicas ou IDs asset:// aprovados. A resolução de saída e os limites de pixels do vídeo de entrada são verificados separadamente.

Tipos de tarefa e restrições

Restrições inválidas de um tipo explícito retornam HTTP 400 antes da criação ou cobrança. Com auto, o modelo deduz o tipo pelas mídias e pelo prompt, podendo falhar durante a geração. Mesmo um tipo explícito pode gerar InvalidParameter.TaskTypeMismatch se entrar em conflito com o prompt.

Exemplos de requisições

Referência multimodal

Quadros inicial e final

Edição de vídeo

Extensão de vídeo

Recursos privados

Aprove primeiro na biblioteca as imagens ou vídeos com rostos reais e depois use asset://. No upload, model também deve ser seedance-2-5-flash. Consulte a API de recursos e use o nome Flash abaixo.
Consulte a revisão pela API unificada de tarefas. Após a aprovação, obtenha o ID asset:// na lista de recursos e use-o em image_urls, image_with_roles[].url, video_urls ou audio_urls.

Status e resultados

Consulte a API de status. pending / processing indicam andamento, completed sucesso e failed falha. Leia data.result.videos[0].url[0]; url é um array.

Cobrança

  • O envio reserva um valor pela tarifa por segundo da resolução. Com referência de vídeo, usa o nível com entrada e soma duração de saída e duração total dos vídeos de referência.
  • Requisições comuns sem duration reservam 5 segundos de saída. duration: -1, ou edit sem duração, reserva 30 segundos de saída.
  • Após o sucesso: data.usage.completion_tokens ÷ 1,000,000 × tarifa aplicável por milhão de tokens, com descontos da conta. A diferença é devolvida ou cobrada. A presença de referência de vídeo determina token ou token-input; o valor final é data.cost.
  • Envios rejeitados não geram cobrança de geração. Se a geração falhar, a reserva é devolvida. Consulte a página de preços.

Erros comuns