Skip to main content
GET
Obtener estado del vídeo
Requiere acceso a la versión preliminar del espacio de trabajo. Consulta Trabajos de vídeo y procesamiento por lotes para la configuración, los webhooks y la gestión de resultados.

Autorizaciones

Authorization
string
header
requerido

Autenticación con token Bearer

Parámetros de ruta

video_id
string
requerido

ID de la solicitud de generación de vídeo.

Respuesta

200 - application/json

Respuesta de estado del vídeo

id
string
polling_url
string
websocket_url
string<uri>

URL de WebSocket para suscribirse a actualizaciones normalizadas del ciclo de vida de trabajos asíncronos.

model
string
request_id
string
session_id
string
status
enum<string>
Opciones disponibles:
queued,
processing,
completed,
failed,
cancelled,
expired
lifecycle_status
enum<string>

Estado normalizado del ciclo de vida asíncrono para consumidores de sondeo, WebSocket y webhooks.

Opciones disponibles:
pending,
running,
completed,
failed,
cancelled,
expired
cancel_url
string<uri> | null

Reservado por compatibilidad; actualmente siempre es null.

output_access
enum<string>
Opciones disponibles:
bytes,
signed_url,
both
generation_id
string | null
native_video_id
string | null

ID de vídeo/trabajo nativo del proveedor cuando difiere del ID propio de la pasarela.

created_at
started_at
completed_at
object
string
Ejemplo:

"video"

poll_after_seconds
integer
Ejemplo:

20

provider
string
seconds
number
size
string
audio
boolean
content_url
string

Presente cuando output_access incluye bytes (endpoint autenticado).

download_url
string | null

URL firmada de primera parte para descarga directa cuando el estado es completed.

expires_at
integer | null

Marca de tiempo Unix (segundos) de caducidad de la download_url firmada.

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

Configuración depurada del webhook asíncrono y estado de entrega. Nunca se devuelven secretos; has_secret indica si las entregas firmadas están habilitadas. Las entregas firmadas incluyen las cabeceras x-phaseo-signature, x-phaseo-timestamp, x-phaseo-event-id, x-phaseo-event-type, x-phaseo-delivery-key, x-phaseo-attempt y x-phaseo-max-attempts.

next_webhook_retry_at
string | null

Marca de tiempo ISO del próximo reintento programado del webhook del usuario, si está en cola.

last_webhook_progress
number | null

Último intervalo aproximado de progreso enviado a los consumidores de webhooks.

last_webhook_progress_at
string | null

Marca de tiempo ISO del envío del intervalo de progreso más reciente del webhook.

last_webhook_dispatched_at
string | null

Marca de tiempo ISO del intento de envío del webhook más reciente.

usage
object
error
unknown
Última modificación el 2 de octubre de 2026