Videos
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 startedprocessing— generation in progress (progressis omitted by the currently listed models)completed— generation complete; readurlfor the video filefailed— generation failed; readerrorfor 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.
Full reference for every endpoint: Markdown · OpenAPI 3.1 JSON
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"
}
}