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