Retrieve a video
GET/v1/videos/:id
Returns a video of the project. While the video is not finished, proxium reads its state from the provider, and the call uses one call slot of the budget. When the video is finished, proxium writes its usage row once, priced by its seconds.
Request
Responses
- 200
- 401
- 402
- 404
- 429
- 503
The video. status is queued, in_progress, completed or failed.
The bearer virtual key is missing (missing_key), or it is not valid or it is revoked (invalid_key).
The project may not send calls (subscription_required). proxium.tech is in open beta and does not return this answer.
The project has no such video (not_found).
The key or the source used its budget window (tenant_capped or source_capped, retry-after: 60), or the project reached a monthly cap (credits_exhausted, retry-after: 3600). No project on proxium.tech has a monthly cap during the open beta.
Response Headers
Seconds to wait before the next call.
The provider could not be reached (upstream_failed), or the operation failed (video_failed). Or: The key store or the limits store is not available (keystore_unavailable, limits_unavailable). A deployment that refuses calls while its budget store is down answers budget_unavailable with retry-after: 5; proxium.tech lets the call through.
Response Headers
Seconds to wait before the next call.