Retrieve a video task

OpenAI-compatible endpoint for retrieving video task status. Returns detailed status information for the video task.

GET /v1/videos/{task_id}

Service root: https://getrouter.ai

Protocol: Video task API

Authentication: Authorization: Bearer YOUR_API_KEY

Parameters

Parameter	Location	Type	Required	Description
`task_id`	path	`string`	Yes	Video task ID

curl --request GET \
  --url https://getrouter.ai/v1/videos/TASK_ID \
  --header "Authorization: Bearer YOUR_API_KEY"

Status	Description
`200`	Video task status retrieved successfully
`404`	Task not found

Field	Type	Required	Description
`id`	`string`	Yes	—
`object`	`string`	Yes	—
`model`	`string`	Yes	—
`status`	`string`	Yes	—
`progress`	`integer`	Yes	—
`created_at`	`integer`	Yes	—
`seconds`	`string`	Yes	—

{
  "id": "string",
  "object": "object",
  "model": "MODEL_ID",
  "status": "completed",
  "progress": 1,
  "created_at": 1,
  "seconds": "string"
}

For complete workflows and examples, read the Video Generation API Guide.

This page is generated from the public Relay OpenAPI specification. Browse the complete specification in the API Explorer.