Skip to main content
POST /api/v1/generate/upload Content-Type: multipart/form-data Upload a short voice reference clip to obtain a voice_id that can be reused across TTS requests without re-uploading the audio file each time. Supported models: higgs2p5, chatterbox, qwen3-tts (Base mode only)

​
Authentication

Send your API key in the Authorization header as a Bearer token. 
Authorization: Bearer YOUR_API_KEY

​
Parameters

NameTypeRequiredDescription
modelstringRequiredThe TTS model to associate the voice with: higgs2p5, chatterbox, or qwen3-tts.
voice_reference_filefileRequiredVoice reference audio file (WAV or MP3 recommended).

​
Response

{
  "voice_id": "abc123def456..."
}
Use the returned voice_id as the voice_id parameter in subsequent Generate Audio or Stream Audio requests.

​
Example

curl -X POST https://api-web.eigenai.com/api/v1/generate/upload \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=higgs2p5" \
  -F "voice_reference_file=@/path/to/reference.wav"