API Documentation

REST API for cloned-voice speech & music generation · available on Pro and Unlimited plans

Requires a paid plan. The external API is enabled for Pro and Unlimited accounts only. Free accounts can use the website, but API requests return 403. Generate a key from your Profile page.

Authentication

Every request must include your API key as a bearer token. Keys are prefixed acv_live_ and are only ever shown once, at creation time.

Authorization: Bearer acv_live_xxxxxxxxxxxxxxxxxxxxxxxx

Alternatively, pass it as an X-API-Key header. Keys carry the same permissions as your account — keep them secret, and revoke immediately if one leaks.

Base URL

https://aiclonevox.com/api

Rate limits

60 requests per minute per key. Exceeding it returns 429 with a JSON error body.

Voices

Method	Path	Description
GET	/voices	List your cloned voices
POST	/voices	Clone a new voice (multipart `audio` file or a public `reference_audio_url`)
DELETE	/voices/:id	Delete a cloned voice

Text-to-speech

Method	Path	Description
POST	/tts	Submit a synthesis job — `{ text, voice_id, model }`
GET	/tts	List your recent jobs
GET	/tts/:id	Poll a job's status / result audio URL

Cost is 1 credit per character (CJK counts as 2), deducted up front and refunded automatically if the job fails. Unlimited-plan keys are never charged.

Example

curl https://aiclonevox.com/api/tts \
  -H "Authorization: Bearer acv_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello from the API.",
    "voice_id": 123,
    "model": "v2-emotion"
  }'

Music

Method	Path	Description
GET	/music/cost	Current credit cost per generation
POST	/music	Generate music — `{ prompt }`
GET	/music/:id	Poll a music task

Errors

Errors are JSON: { "error": "message" }, with a matching HTTP status (400 bad input, 401 missing/invalid key, 402 insufficient credits, 403 plan doesn't include API access, 429 rate limited).

Managing keys

Create, name, and revoke API keys from Profile → API Access. You can hold up to 5 active keys per account; revoking one is immediate and irreversible.