GET
/minimax/v1/query/video_generation查询视频生成任务状态
API Key none
MiniMax 视频 V1 查询
调用与返回说明
查询 V1 Hailuo 视频任务状态和 file_id。
请求时注意
- 请求头使用 `Authorization: Bearer YOUR_API_KEY`；客户端只提交青云TOP API Key，不提交 MiniMax 上游密钥。
- 本文路径是青云TOP 的公开入口。它与 MiniMax 官方路径可能不同；以页面显示的完整本站 URL 为准，不要把官方域名或 `/v2` 自动拼到本站路径。
- 官方模型存在不等于当前 API Key 已开放。调用前请求 `GET /v1/models`，再结合分组权限、当前 pricing 和实际错误响应确认型号；生产 pricing 快照未覆盖全部官方 speech/H3 型号。
- task_id 使用 V1 创建接口返回值，放入 Query 参数；不要与 H3 V2 task_id 跨协议混用。
返回时注意
- HTTP 2xx 只表示请求被网关接受；还要检查响应体中的 `base_resp.status_code`、任务 `status` 或 Responses/兼容协议的业务字段。
- 官方临时音频、视频和文件 URL 有效期有限。成功后立即下载或转存到自己的对象存储，不要把示例地址当作永久资源。
- 余额、分组权限、内容安全、限流和模型下线都可能导致业务失败；记录 trace/request ID 和完整错误信息，按退避策略重试。
- 只有 success 状态才读取 file_id；再通过文件检索接口下载。
Request
请求
/minimax/v1/query/video_generationBody
必填GET 请求无需 JSON 请求体，只需发送页面列出的请求头和路径、查询参数。
路径、查询与 Header 参数
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
task_id | Query | string | 是 | V1 视频任务 ID。 | TASK_ID |
Authorization | Header | string | 是 | 必填。使用青云TOP API 的 API Key，保留 Bearer 后的空格。 | Bearer YOUR_API_KEY |
Response返回响应
成功响应返回响应 200
响应 200objecttask_idstring异步任务 ID，创建成功后原样保存。
statusstringV1 查询状态，例如 preparing、processing、success、failed。
file_idstring任务成功后的文件 ID，用于文件检索。
video_widthinteger视频宽度（查询接口支持时返回）。
video_heightinteger视频高度（查询接口支持时返回）。
base_respobject
base_respobjectstatus_codeinteger业务状态码。
status_msgstring业务状态描述。
MiniMax 视频 V1 查询
调用与返回说明
查询 V1 Hailuo 视频任务状态和 file_id。
请求时注意
- 请求头使用 `Authorization: Bearer YOUR_API_KEY`；客户端只提交青云TOP API Key，不提交 MiniMax 上游密钥。
- 本文路径是青云TOP 的公开入口。它与 MiniMax 官方路径可能不同；以页面显示的完整本站 URL 为准，不要把官方域名或 `/v2` 自动拼到本站路径。
- 官方模型存在不等于当前 API Key 已开放。调用前请求 `GET /v1/models`，再结合分组权限、当前 pricing 和实际错误响应确认型号；生产 pricing 快照未覆盖全部官方 speech/H3 型号。
- task_id 使用 V1 创建接口返回值，放入 Query 参数；不要与 H3 V2 task_id 跨协议混用。
返回时注意
- HTTP 2xx 只表示请求被网关接受；还要检查响应体中的 `base_resp.status_code`、任务 `status` 或 Responses/兼容协议的业务字段。
- 官方临时音频、视频和文件 URL 有效期有限。成功后立即下载或转存到自己的对象存储，不要把示例地址当作永久资源。
- 余额、分组权限、内容安全、限流和模型下线都可能导致业务失败；记录 trace/request ID 和完整错误信息，按退避策略重试。
- 只有 success 状态才读取 file_id；再通过文件检索接口下载。