Router One
Videos

Get Video Generation Status

查询视频生成任务状态。`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"
  }
}

Create Image Generation POST

根据文本提示词生成图片。该接口为同步接口，请求会在图片生成完成后返回；典型耗时 5-30 秒，建议客户端 HTTP 超时设置不少于 60 秒。 响应中的 `data` 数组长度等于实际生成的图片数量，按张数计费。当 `response_format` 为 `url` 时返回的图片链接具有有效期（通常 1 小时），如需长期保存请下载或转存到自有存储。

Submit Video Generation POST

提交视频生成任务。视频生成耗时较长（通常 30 秒到几分钟，取决于模型与时长），因此采用异步任务模式： 1. 调用本接口提交任务，成功响应 `202 Accepted`，返回 `task_id`。 2. 客户端使用 `task_id` 调用 `GET /v1/videos/generations/{task_id}` 轮询状态。 3. 当 `status` 变为 `completed` 时，从响应中读取视频 `url`。 **建议**：轮询间隔不少于 3 秒；不要为整个生成过程设置 HTTP 超时——仅对单次提交/轮询请求设置短超时（如 30 秒）。 **参考图说明**：`image_url` / `image_urls` 字段支持 HTTP(S) URL，单图不超过 20MB。提交后 Router One 会代为下载并安全转存，因此即使图片来自用户上传的临时 URL 也可使用。