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/videosCorpo da solicitação
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
prompt | string | Sim | Descrição textual da cena e do movimento de câmera desejados no vídeo. |
model | string | Não | Identificador do modelo de vídeo, como kling-v4 ou doubao-seedance-2-0-260128. |
duration_seconds | number | Não | Duração do vídeo em segundos (número positivo de até 300, ou o alias duration). |
| Additional fields | object | Não | Parâ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/assetsGET
/v1/seedance/assets/{asset_id}- Registro de recursos: Envie
POST /v1/seedance/assets(operationId: seedance_assets.create) com um JSON contendo os campos obrigatóriossourceUrleassetType(imageouvideo), e o opcionaldisplayName. - 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,failedecancelled. - 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 dePOST /v1/videos(legacy_media.video.create.alias), seguindo a mesma estrutura. - Rota legada de tarefa:
POST /v1/videos/generationsaceita cargas úteis no formatoCreateVideoGenerationRequest. - Pipeline assíncrono unificado:
POST /v1/async-tasks/video-generationsfornece o contrato de ciclo de vida assíncrono padrão da v4.