Get video status | GlobalRouter API

Endpoints

Mobile only shows the endpoint list. View parameter details and examples on desktop.

MethodEndpointDescription

POST/api/v1/videosCreate an OpenRouter-compatible asynchronous video generation job.

POST/api/v1/videos/super-resolution通过公网视频链接和目标分辨率create异步视频超分任务。

GET/api/v1/videos/{jobId}Read an OpenRouter-compatible video generation job.

GET/api/v1/videos/{jobId}/contentDownload generated video content as raw bytes.

GET/api/v1/videos/modelsList authenticated OpenRouter-compatible video models.

GET/api/v1/videos/{jobId}

Requires a Bearer API key with tasks scope. The jobId path parameter must be at least 1 character. Query parameters are not accepted for this compatibility endpoint.

Back to Videos endpoint list

Request parameters

FieldTypeRequiredDescription

AuthorizationheaderyesBearer API key with tasks scope.

jobIdpathyesVideo generation job ID, at least 1 character.

Response fields

FieldTypeRequiredDescription

idstringyesGlobalRouter video generation job ID.

polling_urlstringyesRelative URL for polling the job.

statusstringyespending, in_progress, completed, failed, cancelled, or expired.

errorstringnoFailure message when available.

generation_idstringnoUpstream provider generation ID when available.

unsigned_urlsstring[]noGlobalRouter artifact URLs for completed jobs.

usageobjectnoUsage summary with cost and optional BYOK status.

usage.prompt_tokensintegernoProvider input token usage when available.

usage.completion_tokensintegernoProvider output token usage when available.

usage.total_tokensintegernoProvider total token usage used by token-based pricing rules.

usage.costnumbernoGlobalRouter computed cost for the request.

usage.currencystringnoBilling currency, for example USD on overseas BytePlus routes.

Notes

Provider usage is reported as tokens; GlobalRouter computes cost from configured pricing_rules.
With SR, the response exposes one final video: the enhanced video on success or the original video when SR fails.