Skip to content
Router One
Router One

Get Video Generation Status

Poll a video generation task by `task_id` — `status` is `pending`, `processing`, `completed` (with the video `url`) or `failed` (with an `error`); poll at least 3 s apart. - `pending` — task accepted, not yet started - `processing` — generation in progress (`progress` is omitted by the currently listed models) - `completed` — generation complete; read `url` for the video file - `failed` — generation failed; read `error` for the reason Poll at intervals of at least 3 seconds. Video file URLs have an expiration (typically 24 hours); download or re-host them if you need them long-term.

GET
/v1/videos/generations/{task_id}

Authorization

AuthorizationBearer <token>

Authenticate with your API Key. Get your API Key in the Router One console; the format is sk-xxx.

In: header

Path Parameters

task_idstring

The task identifier returned by the submit endpoint. Treat as an opaque string and pass it back as-is — do not parse its internal structure.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.router.one/v1/videos/generations/v_8f3a92c1d4e74b6ea0b5f1d29c7e8a01"

{
  "task_id": "v_8f3a92c1d4e74b6ea0b5f1d29c7e8a01",
  "status": "processing"
}

{
  "error": {
    "message": "string",
    "type": "string",
    "code": "string",
    "request_id": "string"
  }
}
{
  "error": {
    "message": "task not found",
    "type": "invalid_request_error",
    "code": "INVALID_REQUEST",
    "request_id": "290dd478f91d8aec68f7535e871376eb"
  }
}
{
  "error": {
    "message": "provider is currently unavailable",
    "type": "service_unavailable",
    "code": "PROVIDER_UNAVAILABLE",
    "request_id": "290dd478f91d8aec68f7535e871376eb"
  }
}
{
  "error": {
    "message": "upstream timeout",
    "type": "service_unavailable",
    "code": "PROVIDER_UNAVAILABLE",
    "request_id": "290dd478f91d8aec68f7535e871376eb"
  }
}