Skip to main content
POST
Criar vídeo
Requer acesso à prévia no espaço de trabalho. Consulte Tarefas de vídeo e processamento em lote para configuração, webhooks e tratamento de resultados.

Autorizações

Authorization
string
header
obrigatório

Autenticação com token Bearer

Corpo

application/json
model
string
obrigatório
prompt
string
obrigatório
duration
integer

Duração desejada em segundos (depende do provedor/modelo).

input_video_duration
number<double>

Duração do vídeo de origem em segundos. Obrigatória quando o provedor cobra a duração do vídeo de origem separadamente da saída gerada.

Intervalo obrigatório: 0 < x <= 3600
input_audio_duration
number<double>

Duração declarada do áudio de origem em segundos, usada para validar a faixa do provedor. Provedores que não informam uso definitivo podem cobrar pelo teto de duração de entrada suportado.

Intervalo obrigatório: 2 <= x <= 20
size
string

Dimensões explícitas (por exemplo, 1280x720). Não pode ser combinado com resolution ou aspect_ratio.

resolution
string

480p, 720p, 1080p, 1K, 2K, 4K. Pode ser combinado com aspect_ratio. Não pode ser combinado com size.

aspect_ratio
string

Proporção como 16:9, 9:16 ou 1:1. Pode ser combinado com resolution. Não pode ser combinado com size.

seed
integer
sample_count
integer
Intervalo obrigatório: 1 <= x <= 4
negative_prompt
string
generate_audio
boolean
enhance_prompt
boolean
compression_quality
integer
person_generation
string
resize_mode
string
input_references
object[]

Entradas HTTPS de imagem, áudio ou vídeo que condicionam a geração. Tipos, funções, quantidades e combinações suportados dependem do modelo selecionado. Consulte GET /videos/models antes de enviar um trabalho. O alias singular de compatibilidade input_reference, omitido deste esquema, aceita uma imagem multipart ou um objeto com exatamente um dos campos file_id ou image_url. O suporte depende do provedor.

Entrada de mídia HTTPS tipada. Use image_url para imagens e media_url para áudio ou vídeo. As funções descrevem como o modelo deve usar a entrada; o suporte varia por provedor e modelo.

frame_images
object[]

Imagens HTTPS do primeiro/último quadro. Cada frame_type pode aparecer uma vez. Não forneça também input_reference nem funções de quadro em input_references.

Required array length: 1 - 2 elements
provider_params
object

Somente extensões específicas do provedor. O repasse completo da solicitação e campos duplicados de roteamento, prompt, callback ou cobrança são rejeitados.

provider_options
object

Extensões indexadas pelo ID canônico do provedor (por exemplo, atlascloud ou byteplus). Somente as opções do provedor selecionado são encaminhadas. Não pode ser combinado com provider_params. Campos de roteamento, prompt, callback, duração, resolução e quantidade de saídas devem usar campos validados de nível superior.

output
object
webhook
object
provider
object

Preferências de roteamento de provedores para seleção pelo gateway.

Resposta

202 - application/json

Resposta de vídeo

id
string
polling_url
string
websocket_url
string<uri>

URL de WebSocket para assinar atualizações normalizadas do ciclo de vida de trabalhos assíncronos.

model
string
request_id
string
session_id
string
status
enum<string>
Opções disponíveis:
queued,
processing,
completed,
failed,
cancelled,
expired
lifecycle_status
enum<string>

Status normalizado do ciclo de vida assíncrono para consumidores de polling, WebSocket e webhooks.

Opções disponíveis:
pending,
running,
completed,
failed,
cancelled,
expired
cancel_url
string<uri> | null

Reservado para compatibilidade; atualmente sempre null.

output_access
enum<string>
Opções disponíveis:
bytes,
signed_url,
both
generation_id
string | null
native_video_id
string | null

ID nativo de vídeo/trabalho do provedor quando difere do ID do gateway.

created_at
started_at
completed_at
object
string
Exemplo:

"video"

poll_after_seconds
integer
Exemplo:

20

provider
string
seconds
number
size
string
audio
boolean
content_url
string

Presente quando output_access inclui bytes (endpoint autenticado).

download_url
string | null

URL assinada de primeira parte para download direto quando o status é completed.

expires_at
integer | null

Timestamp Unix (segundos) de expiração da download_url assinada.

progress
integer | null
progress_source
string
asset
object | null
outputs
object[]
billing
object
webhook
object

Configuração sanitizada do webhook assíncrono e estado de entrega. Segredos nunca são retornados; has_secret indica se entregas assinadas estão habilitadas. Entregas assinadas incluem os cabeçalhos x-phaseo-signature, x-phaseo-timestamp, x-phaseo-event-id, x-phaseo-event-type, x-phaseo-delivery-key, x-phaseo-attempt e x-phaseo-max-attempts.

next_webhook_retry_at
string | null

Timestamp ISO da próxima tentativa agendada do webhook do usuário, quando enfileirada.

last_webhook_progress
number | null

Última faixa aproximada de progresso enviada aos consumidores de webhooks.

last_webhook_progress_at
string | null

Timestamp ISO do envio da faixa de progresso mais recente do webhook.

last_webhook_dispatched_at
string | null

Timestamp ISO da tentativa de envio do webhook mais recente.

usage
object
error
unknown
Última modificação em 2 de outubro de 2026