GET
/v1/videos/generations/{taskId}查询视频任务
当上游为异步任务模式时，平台会统一封装任务状态并暴露轮询接口；当前统一状态值为 `PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`。
基础信息
| 鉴权 | Authorization: Bearer sk-... |
| 请求类型 | none |
| 响应类型 | application/json |
请求参数
Path
字段
类型
必填
位置
说明
taskIdstring
是
path
平台任务 ID（数字字符串）。
示例："123"响应示例
json
{
"id": "123",
"upstream_task_id": "task_abc123",
"status": "SUCCEEDED",
"result_url": "https://download.example.com/video_task_123.mp4"
}错误码
| HTTP | code | 说明 |
|---|---|---|
| 400 | invalid_request_error | 请求体结构不合法、缺少必填参数，或 JSON 无法解析。 |
| 401 | invalid_auth_header | 缺少或传错鉴权头，网关无法识别当前调用身份。 |
| 403 | model_not_allowed | 当前 API Key 没有访问该模型的权限。 |
| 402 | insufficient_balance | 余额不足，平台在调用前预检时已拒绝请求。 |
| 503 | model_not_available | 当前模型没有可用路由或上游渠道不可用。 |
在线调试
Playground · 浏览器直连网关
查询视频任务
查询视频生成任务状态与结果地址。
json
尚未发起请求。bash
curl --location --request GET 'https://api.harnmodel.com/v1/videos/generations/123' \
--header 'Authorization: Bearer sk-xxx'多语言示例
bash
curl --location --request GET 'https://api.harnmodel.com/v1/videos/generations/123' \
--header 'Authorization: Bearer sk-xxx'