Voice design

Describe a voice in plain words and Voixa performs it: up to three takes of that voice, each a different performer. Keep the take you like and it becomes a voice of your account, usable everywhere a voice is: speak, podcasts, streaming.

Made for dubbing and storytelling: design one voice per character — the old storyteller, the child, the villain — then read every line with it at normal speech prices. Designing is a one-off; reading is as cheap as any other voice.

How it works

1. Describe. Age, gender, timbre, pace, mood. Any language; English, Vietnamese and Chinese descriptions work best.
2. Listen. POST /designs performs 1–3 takes (about a minute each; the first design after a quiet spell waits for the engine to warm up). Poll GET /designs/{designId}.
3. Keep. POST /designs/{designId}/save turns one take into a voice. From then on it is an ordinary cloned voice with a voiceId.

Takes are drafts kept for 23 hours (expiresAt). Voice design works for every language with voice cloning: Vietnamese, English, French, German, Italian, Spanish and Portuguese (designable in GET /languages).

Tokens. Each take costs rates.design tokens (2 000 by default); keeping one costs rates.clone like any clone. A take that fails is refunded. See Tokens.

Writing a good description

• Say who, then how. "A seven-year-old girl, clear and high voice, cheerful" beats "cute voice".
• Give three to five traits. Age, timbre (deep, husky, bright, breathy), pace (slow, fast), mood (calm, menacing, warm).
• Three takes, not one. The same description gives three different performers; pick the one that fits.
• Change the line to fit the character. text is what the takes read. A line in character tells you more than the default sentence.

The design model

Design a voice

curl -X POST https://api.voixa.vovix.io/v1/designs \
  -H "x-api-key: $VOIXA_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "description": "An old man in his seventies, hoarse and deep, telling a story slowly",
    "language": "vi",
    "count": 3
  }'

{
  "design": {
    "designId": "5b2f0c1e-8f7a-4d0b-9a51-2f0f3d3f6c11",
    "description": "An old man in his seventies, hoarse and deep, telling a story slowly",
    "language": "vi",
    "text": "Xin chào, đây là giọng đọc mẫu của Voixa. Nội dung của bạn sẽ được đọc bằng chất giọng này.",
    "count": 3,
    "status": "processing",
    "candidates": [
      { "index": 0, "status": "processing" },
      { "index": 1, "status": "processing" },
      { "index": 2, "status": "processing" }
    ],
    "savedVoiceIds": [],
    "tokens": 6000,
    "expiresAt": "2026-09-30T10:12:00.000Z",
    "expired": false
  }
}

Retrieve a design

{
  "design": {
    "designId": "5b2f0c1e-8f7a-4d0b-9a51-2f0f3d3f6c11",
    "status": "ready",
    "candidates": [
      { "index": 0, "status": "ready", "durationSec": 6.72, "url": "https://…/0.wav?…" },
      { "index": 1, "status": "ready", "durationSec": 7.36, "url": "https://…/1.wav?…" },
      { "index": 2, "status": "failed" }
    ]
  }
}

Keep a take

curl -X POST https://api.voixa.vovix.io/v1/designs/$DESIGN_ID/save \
  -H "x-api-key: $VOIXA_API_KEY" \
  -H "content-type: application/json" \
  -d '{ "candidate": 1, "name": "Grandpa Ba", "gender": "male" }'