文件上传
上传音频 / 图片 / 视频 → 获取 6 小时有效的公网 URL
MixVoice 的大部分接口都要求入参是公网可访问的 URL(audio_url、image_url 等)。如果你的文件不在公网上,先传到这里——文件会存到阿里云 OSS,返回一个 6 小时有效的签名 URL。
Base URL:
https://api.aiclonevoicefree.com| 鉴权:Authorization: Bearer sk_...
POST /api/v2/uploads
multipart 表单上传,字段名 file。免费。
| Content-Type | multipart/form-data |
| 字段 | file —— 要上传的文件 |
| 大小上限 | 50 MB |
| 支持类型 | 音频 mp3 / wav / m4a / aac / flac / ogg / opus · 图片 png / jpg / jpeg / gif / webp / bmp / heic · 视频 mp4 / mov / avi / mkv / webm / flv / wmv / m4v / mpeg / mpg / 3gp / ts / m2ts |
响应 200
{
"url": "https://myvoices.oss-cn-guangzhou.aliyuncs.com/uploads/tmp/xxxx_speech.mp3?X-Amz-Expires=21600&X-Amz-Signature=...",
"expires_at": 1788777600,
"expires_in": 21600,
"size": 1234567,
"content_type": "audio/mpeg",
"filename": "speech.mp3"
}url—— 直接传给任何接口的audio_url/image_url/input_video_url字段expires_in—— 固定21600(6 小时);到期后 URL 失效,请在有效期内提交任务。过期后重新上传即可获得新 URL。
示例
# 1) 上传本地音频
curl -X POST https://api.aiclonevoicefree.com/api/v2/uploads \
-H "Authorization: Bearer sk_your_api_key" \
-F "file=@./speech.mp3"
# → { "url": "https://myvoices.oss-cn-guangzhou.aliyuncs.com/uploads/tmp/...", "expires_in": 21600, ... }
# 2) 把返回的 URL 传给任意接口
curl -X POST https://api.aiclonevoicefree.com/api/v2/avatar/digital-human \
-H "Authorization: Bearer sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"image_url": "https://myvoices.oss-cn-guangzhou.aliyuncs.com/uploads/tmp/xxxx_portrait.png?...",
"audio_url": "https://myvoices.oss-cn-guangzhou.aliyuncs.com/uploads/tmp/xxxx_speech.mp3?..."
}'错误
| 错误码 | 含义 |
|---|---|
400 bad_input | 文件缺失/为空、类型不支持或超过 50 MB |
503 service_unavailable | 上传存储未配置(请联系客服) |
502 upload_failed | 存储出错,请重试 |