Appearance
上传文件
POST
/v1/files/upload
上传一个可以在多个接口使用的文件。
Authorizations
BearerAuth
TypeHTTP (bearer)
Request Body
Content Type: multipart/form-data
请按multipart/form-data规范提交数据，不要使用JSON格式。file字段用于上传二进制文件，url字段用于提交文件URL。
Schema
file string
要上传的文件内容（不是文件名），大小限制 10 MB，与url参数二选一。
Format binary
url string
要上传的文件url，与file参数二选一。
purpose stringrequired
上传文件的预期用途。
用途说明如下：
- reference: 支持格式(mp3, m4a)。支持音频时长范围为[30,30]秒，超出最大时长的部分会被裁剪掉。
- melody: 支持格式(mp3, m4a, mid)。使用上传音频里提取的哼唱的人声，建议上传midi文件，支持音频时长范围为[5,60]秒，超出最大时长的部分会被裁剪掉。
- instrumental: 支持格式(mp3, m4a)。支持音频时长范围为[30,30]秒，超出最大时长的部分会被裁剪掉。
- voice: 支持格式(mp3, m4a)。支持音频时长范围为[5,15]秒，超出最大时长的部分会被裁剪掉。
- audio: 支持格式(mp3, m4a)。通用的音频文件，用于歌曲续写等功能。
- remix: 支持格式(mp3, m4a)。用于混音重制，支持音频时长范围为[10,350]秒。
- soundtrack: 支持视频和图片，大文件使用url。视频支持格式(.mp4, .mov, .avi, .mkv, .webm)，大小限制 100 MB。图片支持格式(.jpg, .jpeg, .png, .webp)，大小限制 50 MB。
- lyrics-video: 支持格式(.jpg, .jpeg, .png, .webp, .gif)。通用的图片文件，用于歌词视频背景图。
Valid valuesreferencemelodyinstrumentalvoiceaudioremixsoundtracklyrics-video
Responses
上传的文件对象。
application/json
POST
/v1/files/upload