GET
/minimax/v1/files/retrieve检索(用于视频下载,异步音频下载)
API Key none
MiniMax 文件检索与下载
调用与返回说明
用异步 TTS 或视频查询返回的 file_id 获取文件元数据和临时下载 URL。
请求时注意
- 请求头使用 `Authorization: Bearer YOUR_API_KEY`；客户端只提交青云TOP API Key，不提交 MiniMax 上游密钥。
- 本文路径是青云TOP 的公开入口。它与 MiniMax 官方路径可能不同；以页面显示的完整本站 URL 为准，不要把官方域名或 `/v2` 自动拼到本站路径。
- 官方模型存在不等于当前 API Key 已开放。调用前请求 `GET /v1/models`，再结合分组权限、当前 pricing 和实际错误响应确认型号；生产 pricing 快照未覆盖全部官方 speech/H3 型号。
- file_id 放在 Query 参数中，不要放进 JSON Body。只检索当前账号有权访问的文件。
返回时注意
- HTTP 2xx 只表示请求被网关接受；还要检查响应体中的 `base_resp.status_code`、任务 `status` 或 Responses/兼容协议的业务字段。
- 官方临时音频、视频和文件 URL 有效期有限。成功后立即下载或转存到自己的对象存储，不要把示例地址当作永久资源。
- 余额、分组权限、内容安全、限流和模型下线都可能导致业务失败；记录 trace/request ID 和完整错误信息，按退避策略重试。
- download_url 是临时地址；下载失败时重新检索，不要将 URL 永久缓存。
Request
请求
/minimax/v1/files/retrieveBody
必填GET 请求无需 JSON 请求体，只需发送页面列出的请求头和路径、查询参数。
路径、查询与 Header 参数
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
file_id | Query | string | 是 | 文件唯一标识。 | FILE_ID |
Response返回响应
成功响应返回响应 200
响应 200objectfileobject
fileobjectfile_idstring必填文件 ID，后续音色复刻、异步下载或视频结果检索使用。
bytesinteger文件字节数。
filenamestring原始文件名。
purposestring文件用途。
download_urlstring检索接口返回的临时下载 URL，需及时转存。
base_respobject
base_respobjectstatus_codeinteger业务状态码。
status_msgstring业务状态描述。
MiniMax 文件检索与下载
调用与返回说明
用异步 TTS 或视频查询返回的 file_id 获取文件元数据和临时下载 URL。
请求时注意
- 请求头使用 `Authorization: Bearer YOUR_API_KEY`；客户端只提交青云TOP API Key，不提交 MiniMax 上游密钥。
- 本文路径是青云TOP 的公开入口。它与 MiniMax 官方路径可能不同；以页面显示的完整本站 URL 为准，不要把官方域名或 `/v2` 自动拼到本站路径。
- 官方模型存在不等于当前 API Key 已开放。调用前请求 `GET /v1/models`，再结合分组权限、当前 pricing 和实际错误响应确认型号；生产 pricing 快照未覆盖全部官方 speech/H3 型号。
- file_id 放在 Query 参数中，不要放进 JSON Body。只检索当前账号有权访问的文件。
返回时注意
- HTTP 2xx 只表示请求被网关接受；还要检查响应体中的 `base_resp.status_code`、任务 `status` 或 Responses/兼容协议的业务字段。
- 官方临时音频、视频和文件 URL 有效期有限。成功后立即下载或转存到自己的对象存储，不要把示例地址当作永久资源。
- 余额、分组权限、内容安全、限流和模型下线都可能导致业务失败；记录 trace/request ID 和完整错误信息，按退避策略重试。
- download_url 是临时地址；下载失败时重新检索，不要将 URL 永久缓存。