上传文件
GET
/v1/files/upload本接口暂时只提供邀请制客户使用,如有使用需求的客户可以通过客户经理或者通过我们的官方邮箱账户open-platform@minimaxi.com进行申请使用。
本接口本身为无状态接口,即单次调用时,模型所接收到的信息量仅为接口传入内容,不涉及业务逻辑,同时模型也不存储您传入的数据。
本接口适用场景:IP复刻、音色克隆等需要快速复刻某一音色的相关场景。
本接口支持按照指定音频文件快速复刻相同音色的语音
快速复刻功能实现具体操作流程如下:
- 通过Flie接口上传文件,得到file_id
具体相关内容详见:Flie(文档)
- 将得到的file_id以及自定义的voice_id作为输入参数,调用本接口进行音频快速复刻
- 可根据实际使用需求调用语音生成接口(使用复刻voice_id),支持的语音生成接口分别为:T2A、T2A Pro、T2A Large、T2A Stream
支持上传的文件需遵从以下规范:
- 上传的音频文件格式需为:mp3、m4a、wav格式
- 上传的音频文件的时长最少应不低于30秒,最长应不超过5分钟
- 上传的音频文件大小需不超过20mb
参数位置 | 参数 | 语义 | 是否必填 | 类型 | 取值 |
---|---|---|---|---|---|
body form-data | file | 文件本身 | 是 | 二进制文件 | |
body form-data | purpose | 文件目的 | 是 | string | voice_clone |
4、完整示例
示例说明
1、上传原始音频文件得到fileid
2、调用快速复刻接口进入训练,训练后模型返回voiceid
请求示例(Python)
Python 示例
import json
import requests
group_id = "${group_id}"
#音频上传
url = 'https://api.minimax.chat/v1/files/upload?GroupId=${group_id}'
headers1 = {
'authority': 'api.minimax.chat',
'Authorization': 'Bearer ${api_key}'
}
data = {
'purpose': 'voice_clone'
}
files = {
'file': open('output.mp3', 'rb')
}
response = requests.post(url, headers=headers1, data=data, files=files)
file_id = response.json().get("file").get("file_id")
print(file_id)
#音频复刻
url = "https://api.minimax.chat/v1/voice_clone?GroupId=${group_id}"
payload2 = json.dumps({
"file_id": ${file_id},
"voice_id": "test1234"
})
headers2 = {
'authorization': 'Bearer ${api_key}',
'content-type': 'application/json'
}
response = requests.request("POST", url, headers=headers2, data=payload2)
print(response.text)
返回示例(Python)
Python 示例
${file_id}
{"input_sensitive":false,"input_sensitive_type":0,"base_resp":{"status_code":0,"status_msg":"success"}}
请求参数
Query 参数
GroupId
string
必需
示例值:
${group_id}
Header 参数
authority
string
必需
示例值:
api.minimax.chat
Authorization
string
必需
示例值:
Bearer ${api_key}
Body 参数multipart/form-data
purpose
string
必需
示例值:
retrieval
file
string
必需
示例值:
/Users/minimax/Downloads/export_file (1).csv
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
input_sensitive
boolean
必需
input_sensitive_type
integer
必需
base_resp
object
必需
status_code
integer
必需
status_msg
string
必需
示例
{
"input_sensitive": false,
"input_sensitive_type": 0,
"base_resp": {
"status_code": 0,
"status_msg": "success"
}
}
最后修改时间: 1 年前