POST
/minimax/v1/files上传复刻音频
API Key multipart/form-data
MiniMax 文件上传
调用与返回说明
上传音频或长文本文件，返回 file_id 供音色复刻、异步 TTS 或结果下载使用。
请求时注意
- 请求头使用 `Authorization: Bearer YOUR_API_KEY`；客户端只提交青云TOP API Key，不提交 MiniMax 上游密钥。
- 本文路径是青云TOP 的公开入口。它与 MiniMax 官方路径可能不同；以页面显示的完整本站 URL 为准，不要把官方域名或 `/v2` 自动拼到本站路径。
- 官方模型存在不等于当前 API Key 已开放。调用前请求 `GET /v1/models`，再结合分组权限、当前 pricing 和实际错误响应确认型号；生产 pricing 快照未覆盖全部官方 speech/H3 型号。
- 这是 multipart/form-data 上传，客户端自动生成 boundary；不要手写 application/json Content-Type。文件用途 purpose 必须与后续接口匹配。
- 上传接口的 file_id 是资源 ID，不是语音或视频任务 ID。
返回时注意
- HTTP 2xx 只表示请求被网关接受；还要检查响应体中的 `base_resp.status_code`、任务 `status` 或 Responses/兼容协议的业务字段。
- 官方临时音频、视频和文件 URL 有效期有限。成功后立即下载或转存到自己的对象存储，不要把示例地址当作永久资源。
- 余额、分组权限、内容安全、限流和模型下线都可能导致业务失败；记录 trace/request ID 和完整错误信息，按退避策略重试。
- 仅保存 file_id、用途和文件大小等元数据；下载 URL 只在检索接口返回并可能过期。
Request
请求
/minimax/v1/filesBody
必填Bodyobjectfilefile必填待上传的音频、txt 或 zip 文件。
示例
sample.mp3purposestring文件用途；按当前入口支持的枚举填写。
示例
voice_cloneResponse返回响应
成功响应返回响应 200
响应 200objectfileobject
fileobjectfile_idstring必填文件 ID，后续音色复刻、异步下载或视频结果检索使用。
bytesinteger文件字节数。
filenamestring原始文件名。
purposestring文件用途。
download_urlstring检索接口返回的临时下载 URL，需及时转存。
base_respobject
base_respobjectstatus_codeinteger业务状态码。
status_msgstring业务状态描述。
MiniMax 文件上传
调用与返回说明
上传音频或长文本文件，返回 file_id 供音色复刻、异步 TTS 或结果下载使用。
请求时注意
- 请求头使用 `Authorization: Bearer YOUR_API_KEY`；客户端只提交青云TOP API Key，不提交 MiniMax 上游密钥。
- 本文路径是青云TOP 的公开入口。它与 MiniMax 官方路径可能不同；以页面显示的完整本站 URL 为准，不要把官方域名或 `/v2` 自动拼到本站路径。
- 官方模型存在不等于当前 API Key 已开放。调用前请求 `GET /v1/models`，再结合分组权限、当前 pricing 和实际错误响应确认型号；生产 pricing 快照未覆盖全部官方 speech/H3 型号。
- 这是 multipart/form-data 上传，客户端自动生成 boundary；不要手写 application/json Content-Type。文件用途 purpose 必须与后续接口匹配。
- 上传接口的 file_id 是资源 ID，不是语音或视频任务 ID。
返回时注意
- HTTP 2xx 只表示请求被网关接受；还要检查响应体中的 `base_resp.status_code`、任务 `status` 或 Responses/兼容协议的业务字段。
- 官方临时音频、视频和文件 URL 有效期有限。成功后立即下载或转存到自己的对象存储，不要把示例地址当作永久资源。
- 余额、分组权限、内容安全、限流和模型下线都可能导致业务失败；记录 trace/request ID 和完整错误信息，按退避策略重试。
- 仅保存 file_id、用途和文件大小等元数据；下载 URL 只在检索接口返回并可能过期。