Skip to main content
GET
Obter status do 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

Parâmetros de caminho

video_id
string
obrigatório

ID da solicitação de geração de vídeo.

Resposta

200 - application/json

Resposta de status do 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