Skip to main content
GET
Obtenir l’état d’une vidéo
Nécessite l’accès à la préversion dans l’espace de travail. Consultez Tâches vidéo et traitement par lots pour la configuration, les webhooks et le traitement des résultats.

Autorisations

Authorization
string
header
requis

Authentification par jeton Bearer

Paramètres de chemin

video_id
string
requis

ID de la demande de génération vidéo.

Réponse

200 - application/json

Réponse d’état vidéo

id
string
polling_url
string
websocket_url
string<uri>

URL WebSocket permettant de s’abonner aux mises à jour normalisées du cycle de vie des tâches asynchrones.

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

État normalisé du cycle de vie asynchrone pour les consommateurs par interrogation, WebSocket et webhook.

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

Réservé à la compatibilité ; actuellement toujours null.

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

ID vidéo/tâche natif du fournisseur lorsqu’il diffère de l’ID de la passerelle.

created_at
started_at
completed_at
object
string
Exemple:

"video"

poll_after_seconds
integer
Exemple:

20

provider
string
seconds
number
size
string
audio
boolean
content_url
string

Présent lorsque output_access inclut bytes (endpoint authentifié).

download_url
string | null

URL signée de première partie pour le téléchargement direct lorsque l’état est completed.

expires_at
integer | null

Horodatage Unix (secondes) d’expiration de la download_url signée.

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

Configuration nettoyée du webhook asynchrone et état de livraison. Les secrets ne sont jamais renvoyés ; has_secret indique si les livraisons signées sont activées. Les livraisons signées incluent les en-têtes x-phaseo-signature, x-phaseo-timestamp, x-phaseo-event-id, x-phaseo-event-type, x-phaseo-delivery-key, x-phaseo-attempt et x-phaseo-max-attempts.

next_webhook_retry_at
string | null

Horodatage ISO de la prochaine tentative programmée du webhook utilisateur, si en attente.

last_webhook_progress
number | null

Dernière tranche de progression approximative envoyée aux consommateurs de webhooks.

last_webhook_progress_at
string | null

Horodatage ISO de l’envoi de la dernière tranche de progression du webhook.

last_webhook_dispatched_at
string | null

Horodatage ISO de la tentative d’envoi du webhook la plus récente.

usage
object
error
unknown
Dernière modification le 2 octobre 2026