Skip to main content
POST
/api/v1/audio/voices
ارفع عينة صوتية لإنشاء معرّف صوت مستنسخ، ثم مرّره كقيمة voice إلى /audio/speech مع نفس model المستخدم لإنشائه. للاطلاع على شرح تفصيلي، راجع دليل استنساخ الصوت.

التفويضات

Authorization
string
header
مطلوب

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

الجسم

multipart/form-data

Request to create a cloned voice from an audio sample. The returned vv_<id> handle is passed back as the voice parameter on POST /v1/audio/speech.

file
file

The voice sample audio file (multipart/form-data, field name "file"). Accepted containers depend on the selected model: tts-chatterbox-hd accepts MP3, WAV, FLAC, and M4A; tts-minimax-speech-02-hd accepts MP3 and WAV only. Recommended: a clean speech recording of at least 5–10 seconds.

model
enum<string>
افتراضي:tts-chatterbox-hd

The Venice TTS model the cloned voice will be paired with. The returned voice handle is only valid against this model on POST /v1/audio/speech.

الخيارات المتاحة:
tts-chatterbox-hd,
tts-minimax-speech-02-hd
مثال:

"tts-chatterbox-hd"

الاستجابة

Voice cloned successfully

id
string
مطلوب

The cloned voice handle. Pass this to POST /v1/audio/speech as the voice parameter alongside the same model used to create it. Handles expire automatically after the per-model retention window (currently 7 days for both supported models); for tts-minimax-speech-02-hd each successful TTS request resets that window.

مثال:

"vv_voice_abc123xyz"

model
string
مطلوب

The Venice TTS model this voice can be used with.

مثال:

"tts-chatterbox-hd"