文件上传

POST

http://0.0.0.0:8000/minimax/v1/files/upload

最后修改时间：2025-07-16 03:42:43

责任人：未设置

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

upstream_api_key

string

必需

示例值:

1926727132189303566|eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJHcm91cE5hbWUiOiJ4eCIsIlVzZXJOYW1lIjoieHgiLCJBY2NvdW50IjoiIiwiU3ViamVjdElEIjoiMTkyNjcyNzEzMjE5MzQ5Nzg3MCIsIlBob25lIjoiMTkyODQ0MzI1MzMiLCJHcm91cElEIjoiMTkyNjcyNzEzMjE4OTMwMzU2NiIsIlBhZ2VOYW1lIjoiIiwiTWFpbCI6IiIsIkNyZWF0ZVRpbWUiOiIyMDI1LTA1LTI3IDE4OjM1OjIzIiwiVG9rZW5UeXBlIjoyLCJpc3MiOiJtaW5pbWF4In0.yUlyEhtMUI4hr61vkd3rtpVFwMI3qxCDrULaU9AnO8-eyS_yk9s778W8mB62kDSCpXU93xZXLkukhGT88WrrbRvwJsd2j2jAz6UsVs5UfTQzcvJhSDgvTm3zQCOwobRezwXaettGQAiWdaJMBhsjf9X79ISGmwk8Md1jVIH8xIAbrHGGcwx5xEriSQGvlqYaPejoK9LjhVuHXVT-lLvU7Qg6saTaQ--pvmai92JqKb8YIUigfy2zLQImm9iv9W-aWn3pO3ddiaapH49ym6zZi6AgeQmGWu1298I2IsBEZvIrbKVt6vBuryFRUuOUQ3H1omM0GMNy0JEEVU8ACvBh-g

Body 参数multipart/form-data

purpose

enum<string>

必需

文件使用目的。取值及支持格式如下：

retrieval：知识库检索，（支持pdf、docx、txt格式的文档）；

fine-tune：模型finetune，（支持jsonl格式的文件）；

fine-tune-result：模型finetune训练结果；

voice_clone：快速复刻原始文件，（支持mp3、m4a、wav格式）；

prompt_audio: 音色复刻的示例音频，（支持mp3、m4a、wav格式）；

assistants：助手，（支持文件格式请参考【Assistants-操作指南】中【支持文件类型】列表了解详情）；

role-recognition：文本角色分类，（支持txt、json格式的文档；需要注意的是，即使上传的是txt文本，txt文本的正文也需要是json格式）；

t2a_async_input：异步超长文本语音生成传入合成文本文件。

枚举值:

retrievalfine-tunefine-tune-resultvoice_cloneprompt_audioassistantsrole-recognitiont2a_async_input

file

必需

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://0.0.0.0:8000/minimax/v1/files/upload' \
--header 'upstream_api_key: 1926727132189303566|eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJHcm91cE5hbWUiOiJ4eCIsIlVzZXJOYW1lIjoieHgiLCJBY2NvdW50IjoiIiwiU3ViamVjdElEIjoiMTkyNjcyNzEzMjE5MzQ5Nzg3MCIsIlBob25lIjoiMTkyODQ0MzI1MzMiLCJHcm91cElEIjoiMTkyNjcyNzEzMjE4OTMwMzU2NiIsIlBhZ2VOYW1lIjoiIiwiTWFpbCI6IiIsIkNyZWF0ZVRpbWUiOiIyMDI1LTA1LTI3IDE4OjM1OjIzIiwiVG9rZW5UeXBlIjoyLCJpc3MiOiJtaW5pbWF4In0.yUlyEhtMUI4hr61vkd3rtpVFwMI3qxCDrULaU9AnO8-eyS_yk9s778W8mB62kDSCpXU93xZXLkukhGT88WrrbRvwJsd2j2jAz6UsVs5UfTQzcvJhSDgvTm3zQCOwobRezwXaettGQAiWdaJMBhsjf9X79ISGmwk8Md1jVIH8xIAbrHGGcwx5xEriSQGvlqYaPejoK9LjhVuHXVT-lLvU7Qg6saTaQ--pvmai92JqKb8YIUigfy2zLQImm9iv9W-aWn3pO3ddiaapH49ym6zZi6AgeQmGWu1298I2IsBEZvIrbKVt6vBuryFRUuOUQ3H1omM0GMNy0JEEVU8ACvBh-g' \
--form 'purpose=""' \
--form 'file=@""'

返回响应

🟢200成功

application/json

Body

file

object

必需

file_id

integer

必需

bytes

integer

必需

created_at

integer

必需

filename

string

必需

purpose

string

必需

base_resp

object

必需

status_code

integer

必需

status_msg

string

必需

示例

{
    "file": {
        "file_id": 291157699412088,
        "bytes": 18,
        "created_at": 1752637348,
        "filename": "response.mp3",
        "purpose": "voice_clone"
    },
    "base_resp": {
        "status_code": 0,
        "status_msg": "success"
    }
}

修改于 2025-07-16 03:42:43

语音克隆