Router One
Router One
视频生成

查询视频生成状态

查询视频生成任务状态。`status` 字段取值： - `pending` — 任务已接受，尚未开始处理 - `processing` — 正在生成，可读取 `progress` - `completed` — 生成完成，读取 `url` 获取视频文件 - `failed` — 生成失败，读取 `error` 获取原因 建议轮询间隔不少于 3 秒。视频文件 URL 具有有效期（通常 24 小时），如需长期保存请下载或转存到自有存储。

GET
/v1/videos/generations/{task_id}

Authorization

AuthorizationBearer <token>

使用 API Key 进行认证。在 Router One 控制台获取你的 API Key，格式为 sk-xxx。

In: header

Path Parameters

task_idstring

提交接口返回的任务标识，作为不透明字符串原样回传即可，无需解析其内部结构。

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",
  "progress": 45
}

{
  "error": {
    "message": "Invalid task_id",
    "type": "invalid_request_error",
    "code": "invalid_task_id"
  }
}
{
  "error": {
    "message": "string",
    "type": "string",
    "code": "string"
  }
}
{
  "error": {
    "message": "Task not found",
    "type": "invalid_request_error",
    "code": "task_not_found"
  }
}
{
  "error": {
    "message": "string",
    "type": "string",
    "code": "string"
  }
}