Trang này hiện chỉ có bản tiếng Trung. Điều hướng và menu đã hiển thị bằng tiếng Việt.

查询视频生成任务

GET /v1/videos/{id}?model={model} 查询异步任务。model 查询参数必须与创建请求相同。新任务的 ID 是以 ioa_v1. 开头的签名句柄，绑定创建时的映射和上游凭据；仍须显式提供 model。

请求字段

路径参数 id：创建响应中的完整任务 ID，作为不透明字符串保存并 URL 编码，不要替换成上游 ID。查询参数 model：创建时的 InOneAPI 公共模型 ID，必填。Authorization：与创建任务相同用户所有、具有该模型权限的有效 API Key。没有请求体，也没有分页参数。下方 ID 为占位符，需替换为实际创建响应。

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

响应字段

{
  "id":"ioa_v1.REPLACE_WITH_RETURNED_TASK_ID",
  "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
}

字段	类型	响应字段
`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":"ioa_v1.REPLACE_WITH_RETURNED_TASK_ID","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。不要把临时查询故障当作重新创建任务的理由。

当前限制

新任务的签名句柄校验所属用户和公共模型，将查询固定到创建时的映射与上游凭据，不依赖平台任务数据库。签名无效、用户或模型不匹配返回 404 VIDEO_TASK_NOT_FOUND；原映射或凭据不可用时不会自动换服务商查询，可能返回 503 UPSTREAM_UNAVAILABLE。旧版原始任务 ID 没有同等绑定保证，应保留其原有上游配置。平台不提供统一取消能力；回调仅来自支持它的服务商，不由网关发送。

在线体验

控制台 Playground 和模型详情的“立即体验”支持文本生成视频，自动每 3 秒查询任务，单次等待最长 10 分钟。停止等待或查询失败后，可用“继续查询”读取原任务，避免重复创建；停止等待不等于取消上游生成。成功结果使用视频播放器展示。控制台已保存的会话保留视频任务和结果地址；外部地址仍可能过期。