Skip to main content
POST

Limits

Authorizations

x-api-key
string
header
required

Your ZeroGPU API key. Create one in the dashboard under API keys. Send it on every request.

Body

Multipart form, required for voice cloning.

input
string<textarea>
required

The text to speak. Inline tags such as [laugh] and [cough] add paralinguistic cues.

Required string length: 1 - 2000
Example:

"Testing model to generate voice. Hey how are you today?"

model
enum<string>
default:chatterbox-nano

Model identifier. The endpoint serves chatterbox-nano.

Available options:
chatterbox-nano
Example:

"chatterbox-nano"

voice
enum<string>
default:default

OpenAI voice names are accepted and all map to the built-in voice.

Available options:
default,
builtin,
chatterbox,
alloy,
ash,
ballad,
cedar,
coral,
echo,
fable,
marin,
nova,
onyx,
sage,
shimmer,
verse
Example:

"default"

response_format
enum<string>
default:mp3

pcm is raw 16-bit little-endian mono at 24 kHz.

Available options:
mp3,
opus,
aac,
flac,
wav,
pcm
Example:

"mp3"

seed
integer

Pins sampling for repeatable output (best-effort).

Required range: 0 <= x <= 4294967295
Example:

1234

temperature
number
default:0.8

Sampling temperature.

Required range: 0 <= x <= 2
top_p
number
default:0.95

Nucleus sampling.

Required range: 0 <= x <= 1
top_k
integer
default:1000

Top-k sampling.

Required range: 0 <= x <= 10000
repetition_penalty
number
default:1.2

Penalty on repeated speech tokens.

Required range: 1 <= x <= 4
voice_sample
file

Reference clip to clone a voice from. Overrides voice. Not stored.

Response

The audio file, with a content type matching response_format.

The response is of type file.