查询视频生成任务

GET /v1/videos/{id}?model={model} 查询异步任务。model 查询参数必须与创建请求相同；当前网关没有任务 ID 到创建路由的持久绑定，仅传 id 无法可靠确定模型。

请求字段

路径参数 id：创建响应中的原始任务 ID，必须 URL 编码。查询参数 model：创建时的 InOneAPI 公共模型 ID，必填。Authorization：与创建任务相同项目的有效 API Key。没有请求体，也没有分页参数。

curl --get 'https://api.inoneapi.com/v1/videos/video_task_01JABCDEF' \
  --header "Authorization: Bearer $INONEAPI_API_KEY" \
  --data-urlencode 'model=provider/video-model'

响应字段

{
  "id":"video_task_01JABCDEF",
  "status":"succeeded",
  "created_at":"2026-09-05T08:30:00Z",
  "completed_at":"2026-09-05T08:31:12Z",
  "video_url":"https://example.com/output.mp4",
  "error":null
}

Field	Type	响应字段
`id`	string	任务 ID；用于后续查询，不是 Trace ID。
`status`	string	queued 排队；running 生成中；succeeded 成功；failed 失败；cancelled 取消；expired 过期。状态映射由服务商配置决定。
`created_at`	string	创建时间，ISO 8601 字符串。上游必须提供或可直接映射；DSL 不自动转换 Unix 时间。
`completed_at`	string/null	完成时间，ISO 8601；运行中可能省略或为 null。
`video_url`	string/null	成功的视频地址，非成功状态通常省略或为 null。是否签名、多久过期由服务商决定；不是永久托管保证。
`error`	object/null	错误对象或 null。code 为机器可读错误码，message 为人可读说明；具体返回取决于映射。

{"id":"video_task_01JABCDEF","status":"failed","error":{"code":"GENERATION_FAILED","message":"Generation could not be completed"}}

轮询与错误处理

建议每 2～5 秒查询并设总超时。仅 queued/running 继续；所有终态停止，包括 failed/cancelled/expired。HTTP 429 遵守 Retry-After；5xx 使用有上限退避；401/403 检查密钥权限，404 检查模型、任务 ID 和上游路由。HTTP 200 不代表生成成功，必须检查 status。不要把临时查询故障当作重新创建任务的理由。

当前限制

查询仍执行模型路由，当前不会绑定创建时的 channel/mapping，也没有平台级任务归属校验与任务存储。多家服务商处理同一模型时，查询可能命中不认识该 ID 的上游；生产使用应将该视频模型固定到创建所用的单一映射。不要宣传跨渠道自动查询或平台统一取消能力。回调仅来自支持它的服务商，不由网关发送。