MiniMax 文件管理

该接口为 MiniMax 语音（音色克隆）、视频（MiniMax-H3 等）、多模态理解等能力的共用文件上传与管理接口。上传素材后可获取 file_id，在后续请求中以 mm_file://{file_id} 形式引用。

上传文件

接口地址

http

POST /v1/files/upload

请求头

参数名	类型	必填	默认值	说明
`Content-Type`	string	是	`multipart/form-data`	数据交换格式
`Authorization`	string	是	-	鉴权信息，格式为 `Bearer <API_KEY>`

请求体（multipart/form-data）

参数名	类型	必填	说明
`purpose`	string	是	文件使用目的。枚举值及支持格式见下表
`file`	binary	是	文件内容

purpose 枚举值：

值	说明	支持格式	其他限制
`voice_clone`	音色快速复刻原始文件	mp3, m4a, wav	时长 ≥10 秒且 ≤5 分钟，≤20 MB
`prompt_audio`	音色复刻示例音频	mp3, m4a, wav	时长 <8 秒，≤20 MB
`t2a_async_input`	异步长文本语音合成输入	text, zip	-
`video_understanding`	视频多模态理解，在对话请求中以 `mm_file://{file_id}` 形式引用	MP4, AVI, MOV, MKV	最长保存 7 天
`video_generation_input`	视频生成输入素材（首帧图/参考图/参考视频/参考音频），在生成请求 content 的 url 字段以 `mm_file://{file_id}` 形式引用	见下表	有效期 7 天（过期后发起生成返回 file expired，需重新上传）；上传即校验规格，不合格返回 400 且不留存，heic/heif 宽高由服务端解析、无需客户端转码

video_generation_input 格式与大小限制：

类型	扩展名	单文件上限
图片	jpg / jpeg / png / webp / heic / heif	30 MB
参考视频	mp4 / mov	50 MB
参考音频	wav / mp3	15 MB

请求示例

bash

curl --request POST \
  --url https://neolink.com/api/minimax/v1/files/upload \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'purpose=voice_clone' \
  --form 'file=@/path/to/audio.mp3'

成功响应（HTTP 200）

json

{
  "file": {
    "file_id": 123456789,
    "bytes": 5896337,
    "created_at": 1700469398,
    "filename": "audio.mp3",
    "purpose": "voice_clone"
  },
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

字段	类型	说明
`file.file_id`	int64	文件唯一标识符
`file.bytes`	int64	文件大小，以字节为单位
`file.created_at`	int64	文件创建时间，Unix 时间戳（秒）
`file.filename`	string	文件名称
`file.purpose`	string	文件使用目的
`base_resp.status_code`	int	状态码；具体定义见错误码
`base_resp.status_msg`	string	状态详情

检索文件

接口地址

http

GET /v1/files/retrieve

请求头

参数名	类型	必填	默认值	说明
`Authorization`	string	是	-	鉴权信息，格式为 `Bearer <API_KEY>`

查询参数

参数名	类型	必填	说明
`file_id`	int64	是	文件唯一标识符

请求示例

bash

curl --request GET \
  --url 'https://neolink.com/api/minimax/v1/files/retrieve?file_id=123456789' \
  --header 'Authorization: Bearer <API_KEY>'

成功响应（HTTP 200）

json

{
  "file": {
    "file_id": 123456789,
    "bytes": 5896337,
    "created_at": 1700469398,
    "filename": "output.mp4",
    "purpose": "video_generation",
    "download_url": "https://download-url.example.com/file.mp4"
  },
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

字段	类型	说明
`file.file_id`	int64	文件唯一标识符
`file.bytes`	int64	文件大小，以字节为单位
`file.created_at`	int64	文件创建时间，Unix 时间戳（秒）
`file.filename`	string	文件名称
`file.purpose`	string	文件使用目的
`file.download_url`	string	文件下载链接
`base_resp.status_code`	int	状态码；具体定义见错误码
`base_resp.status_msg`	string	状态详情

列出文件

接口地址

http

GET /v1/files/list

请求头

参数名	类型	必填	默认值	说明
`Authorization`	string	是	-	鉴权信息，格式为 `Bearer <API_KEY>`

查询参数

参数名	类型	必填	说明
`purpose`	enum<string>	是	列出文件的分类。枚举值：`voice_clone`、`prompt_audio`、`t2a_async_input`、`video_generation_input`

请求示例

bash

curl --request GET \
  --url 'https://neolink.com/api/minimax/v1/files/list?purpose=t2a_async_input' \
  --header 'Authorization: Bearer <API_KEY>'

成功响应（HTTP 200）

json

{
  "files": [
    {
      "file_id": 123456789,
      "bytes": 5896337,
      "created_at": 1699964873,
      "filename": "297990555456011.tar",
      "purpose": "t2a_async_input"
    },
    {
      "file_id": 123456790,
      "bytes": 5896337,
      "created_at": 1700469398,
      "filename": "297990555456911.tar",
      "purpose": "t2a_async_input"
    }
  ],
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

字段	类型	说明
`files`	object[]	文件列表
`files[].file_id`	int64	文件唯一标识符
`files[].bytes`	int64	文件大小，以字节为单位
`files[].created_at`	int64	文件创建时间，Unix 时间戳（秒）
`files[].filename`	string	文件名称
`files[].purpose`	string	文件使用目的
`base_resp.status_code`	int	状态码；具体定义见错误码
`base_resp.status_msg`	string	状态详情

下载文件

接口地址

http

GET /v1/files/retrieve_content

请求头

参数名	类型	必填	默认值	说明
`Authorization`	string	是	-	鉴权信息，格式为 `Bearer <API_KEY>`

查询参数

参数名	类型	必填	说明
`file_id`	int64	是	需要下载的文件 ID

请求示例

bash

curl --request GET \
  --url 'https://neolink.com/api/minimax/v1/files/retrieve_content?file_id=123456789' \
  --header 'Authorization: Bearer <API_KEY>' \
  --output downloaded_file.mp3

成功响应（HTTP 200）

返回文件的二进制内容。Content-Type 取决于原始文件类型。

删除文件

接口地址

http

POST /v1/files/delete

请求头

参数名	类型	必填	默认值	说明
`Content-Type`	string	是	`application/json`	数据交换格式
`Authorization`	string	是	-	鉴权信息，格式为 `Bearer <API_KEY>`

请求体

参数名	类型	必填	说明
`file_id`	int64	是	文件唯一标识符
`purpose`	string	是	文件使用目的。枚举值：`voice_clone`、`prompt_audio`、`t2a_async`、`t2a_async_input`、`video_generation`

请求示例

bash

curl --request POST \
  --url https://neolink.com/api/minimax/v1/files/delete \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "file_id": 123456789,
    "purpose": "voice_clone"
  }'

成功响应（HTTP 200）

json

{
  "file_id": 123456789,
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

字段	类型	说明
`file_id`	int64	被删除的文件 ID
`base_resp.status_code`	int	状态码；具体定义见错误码
`base_resp.status_msg`	string	状态详情

MiniMax/hailuo

MiniMax-H3

MiniMax

Suno

OpenAI 兼容接口

Seedance资源管理

MiniMax 文件管理

上传文件

接口地址

请求头

请求体（multipart/form-data）

请求示例

成功响应（HTTP 200）

检索文件

接口地址

请求头

查询参数

请求示例

成功响应（HTTP 200）

列出文件

接口地址

请求头

查询参数

请求示例

成功响应（HTTP 200）

下载文件

接口地址

请求头

查询参数

请求示例

成功响应（HTTP 200）

删除文件

接口地址

请求头

请求体

请求示例

成功响应（HTTP 200）

MiniMax/hailuo

MiniMax-H3

MiniMax

Suno

OpenAI 兼容接口

Seedance资源管理

MiniMax 文件管理 ​

上传文件 ​

接口地址 ​

请求头 ​

请求体（multipart/form-data） ​

请求示例 ​

成功响应（HTTP 200） ​

检索文件 ​

接口地址 ​

请求头 ​

查询参数 ​

请求示例 ​

成功响应（HTTP 200） ​

列出文件 ​

接口地址 ​

请求头 ​

查询参数 ​

请求示例 ​

成功响应（HTTP 200） ​

下载文件 ​

接口地址 ​

请求头 ​

查询参数 ​

请求示例 ​

成功响应（HTTP 200） ​

删除文件 ​

接口地址 ​

请求头 ​

请求体 ​

请求示例 ​

成功响应（HTTP 200） ​

MiniMax 文件管理

上传文件

接口地址

请求头

请求体（multipart/form-data）

请求示例

成功响应（HTTP 200）

检索文件

接口地址

请求头

查询参数

请求示例

成功响应（HTTP 200）

列出文件

接口地址

请求头

查询参数

请求示例

成功响应（HTTP 200）

下载文件

接口地址

请求头

查询参数

请求示例

成功响应（HTTP 200）

删除文件

接口地址

请求头

请求体

请求示例

成功响应（HTTP 200）