v1

latestOpenAPI 3.0.3Proprietary2026-07-268815.8 KB

Audio

Create a voice

Register a reusable reference voice for cloning. Identical audio re-registered under the same API key returns the existing voice. Pass the returned voice ID to the voice field of POST /v1/audio/speech instead of sending ref_audio on every request.

post/v1/audio/voices

Request body

ref_audiostring required

Reference audio: an http(s) URL, data URI, or base64. Max 10 MB, min 3.0 s.

ref_textstring required

Transcript of the reference audio.

descriptionstring nullable

Description for the voice.

Response

The created (or existing) voice.

voicestring required

Stable ID voice_<sha256>, deterministic per (API key, audio content).

descriptionstring nullable

Description for the voice.

created_atstring nullable

ISO-8601 UTC timestamp.

ref_textstring required

Transcript of the reference audio.