# 上传复刻音频

**方法**: `POST`
**路径**: `/minimax/v1/files/upload`

[官方文档](https://platform.minimaxi.com/docs/api-reference/voice-cloning-uploadcloneaudio)

使用本接口上传用于复刻的音频文件。

## 请求参数

### Header 参数

```text
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}
```

### Body 参数 multipart/form-data 必填

```text
purpose
string
必需
purpose
enumdefault:voice_clonerequired
文件使用目的。取值及支持格式如下：
voice_clone: 快速复刻原始文件，（支持mp3、m4a、wav格式）
可用选项: voice_clone
Example:
"voice_clone"
示例:
voice_clone
file
file
必需
需要上传的文件。填写文件的路径地址
支持上传的文件需遵从以下规范：
上传的音频文件格式需为：mp3、m4a、wav格式
上传的音频文件的时长最少应不低于10秒，最长应不超过5分钟
上传的音频文件大小需不超过20mb
示例:
example-file
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/minimax/v1/files/upload' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--form 'purpose="voice_clone"' \
--form 'file=@"example-file"'
```

## 返回响应

### 🟢 200 成功

**内容类型**: `application/json`

#### 响应结构

```text
file
object
可选
file_id
integer
文件的唯一标识符
可选
bytes
integer
可选
文件大小，以字节为单位
created_at
integer
可选
创建文件时的 Unix 时间戳，以秒为单位
filename
string
文件的名称
可选
purpose
string
文件的使用目的
可选
base_resp
object
可选
status_code
integer
必需
状态码及其分别含义如下：
0，请求成功
1002，触发限流，请稍后再试
1004，账号鉴权失败，请检查 API-Key 是否填写正确
1008，账号余额不足
1026，图片描述涉及敏感内容
2013，传入参数异常，请检查入参是否按要求填写
2049，无效的api key
status_msg
string
状态详情
必需
```

#### 示例

```json
{
    "file": {
        "file_id": "${file_id}",
        "bytes": 5896337,
        "created_at": 1700469398,
        "filename": "复刻音频",
        "purpose": "voice_clone"
    },
    "base_resp": {
        "status_code": 0,
        "status_msg": "success"
    }
}
```