Geração de vídeo e gerenciamento de ativos

Gere vídeos com modelos Kling v4 e Seedance e faça referência a ativos de mídia autorizados.

Envie tarefas de geração de vídeo e gerencie ativos de mídia autorizados por meio dos endpoints nativos de vídeo.

POST/v1/videos

Corpo da solicitação

CampoTipoObrigatórioDescrição
promptstringSimDescrição textual da cena e do movimento de câmera desejados no vídeo.
modelstringNãoIdentificador do modelo de vídeo, como kling-v4 ou doubao-seedance-2-0-260128.
duration_secondsnumberNãoDuração do vídeo em segundos (número positivo de até 300, ou o alias duration).
Additional fieldsobjectNãoParâmetros estendidos de vídeo (como resolution, aspect_ratio, first_frame_url, last_frame_url) são repassados integralmente ao motor subjacente.

Ativos autorizados Seedance

POST/v1/seedance/assets
GET/v1/seedance/assets/{asset_id}
  • Registro de recursos: Envie POST /v1/seedance/assets (operationId: seedance_assets.create) com um JSON contendo os campos obrigatórios sourceUrl e assetType (image ou video), e o opcional displayName.
  • Referências URI: Faça referência direta à mídia registrada usando asset://{asset_id} em URLs de quadros ou parâmetros avançados.
  • Isolamento de locatários: Os recursos são isolados na biblioteca atual do locatário e verificados no armazenamento upstream.

Status da tarefa e download

GET/v1/videos/{task_id}
  • Consulta de status: Consulte o status da tarefa via GET /v1/videos/{task_id} (operationId: legacy_media.video.get), com suporte aos 9 status: queued, submitting, submitted, running, ingesting_artifacts, cancel_requested, completed, failed e cancelled.
  • Download de artefatos: Baixe o arquivo binário de vídeo concluído via GET /v1/videos/{task_id}/content.
  • Suporte ao Kling v4: Suporta totalmente texto para vídeo, imagem de quadro inicial para vídeo e transições de quadro final.

Aliases de compatibilidade

  • Alias de mídia legada: POST /openai/v1/videos é um alias legado de POST /v1/videos (legacy_media.video.create.alias), seguindo a mesma estrutura.
  • Rota legada de tarefa: POST /v1/videos/generations aceita cargas úteis no formato CreateVideoGenerationRequest.
  • Pipeline assíncrono unificado: POST /v1/async-tasks/video-generations fornece o contrato de ciclo de vida assíncrono padrão da v4.