Gateway

Get video status

Retrieves the status for a video generation request. Poll every 20 seconds unless you are using webhooks.

get/videos/{video_id}

Request

  • Base URL: https://api.phaseo.app/v1
  • URL: https://api.phaseo.app/v1/videos/{video_id}
  • Auth: HTTP bearer

Path parameters

video_idstring required

The ID of the video generation request.

Response

Video status response

idstring
polling_urlstring
websocket_urlstring uri

WebSocket URL for subscribing to normalized async job lifecycle updates.

modelstring
request_idstring
session_idstring
status'queued' | 'processing' | 'completed' | 'failed' | 'cancelled' | 'expired'
lifecycle_status'pending' | 'running' | 'completed' | 'failed' | 'cancelled' | 'expired'

Normalized async lifecycle status for polling, websocket, and webhook consumers.

cancel_urlstring uri nullable

Reserved for compatibility; currently always null.

output_access'bytes' | 'signed_url' | 'both'
generation_idstring nullable
native_video_idstring nullable

Provider-native video/job id when it differs from the gateway-owned id.

objectstring
poll_after_secondsinteger
providerstring
secondsnumber
sizestring
audioboolean
content_urlstring

Present when output_access includes bytes (authenticated endpoint).

download_urlstring nullable

Signed first-party URL for direct download when status is completed.

expires_atinteger nullable

Unix timestamp (seconds) when the signed download_url expires.

progressinteger nullable
progress_sourcestring
next_webhook_retry_atstring nullable

ISO timestamp for the next scheduled user-webhook retry, when queued.

last_webhook_progressnumber nullable

Most recent coarse progress bucket dispatched to webhook consumers.

last_webhook_progress_atstring nullable

ISO timestamp when the most recent webhook progress bucket was dispatched.

last_webhook_dispatched_atstring nullable

ISO timestamp for the most recent webhook dispatch attempt.

errorunknown

Example response

{
  "object": "video",
  "poll_after_seconds": 20,
  "webhook": {
    "delivery": {
      "delivered_event_types": [
        "video.completed"
      ]
    },
    "attempts": [
      {
        "delivery_key": "video.completed",
        "event_type": "video.completed"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.