File Upload

Most MixVoice endpoints take public URLs for input (audio_url, image_url, ...). If your files aren't hosted anywhere, upload them here first — the file is stored on Alibaba Cloud OSS and you get back a signed URL valid for 6 hours.

Base URL: https://api.aiclonevoicefree.com | Auth: Authorization: Bearer sk_...

`POST /api/v2/uploads`

Multipart form upload, field name file. Free of charge.


Content-Type	`multipart/form-data`
Field	`file` — the file to upload
Max size	50 MB
Allowed types	Audio mp3 / wav / m4a / aac / flac / ogg / opus · Image png / jpg / jpeg / gif / webp / bmp / heic · Video mp4 / mov / avi / mkv / webm / flv / wmv / m4v / mpeg / mpg / 3gp / ts / m2ts

Response 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 — pass it straight into any audio_url / image_url / input_video_url field
expires_in — always 21600 (6 hours); after that the URL stops working, so submit your tasks within the window. Upload again to get a fresh URL.

Example

# 1) Upload a local audio file
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) Use the returned URL in any endpoint
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?..."
  }'

Errors

Code	Meaning
`400 bad_input`	Missing/empty file, unsupported type, or over 50 MB
`503 service_unavailable`	Upload storage not configured (contact support)
`502 upload_failed`	Storage error — retry

POST /api/v2/uploads

Example

Errors

On this page

`POST /api/v2/uploads`