Fields
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
Input | string | :heavy_check_mark: | Text to synthesize | Hello world |
InputReferences | []components.SpeechInputReference | :heavy_minus_sign: | Reference content for stateless voice cloning: one input_audio part carrying the voice sample, optionally accompanied by one text part with its transcript. Only routed to endpoints that support voice cloning. | [ { “input_audio”: { “data”: “data:audio/wav;base64,UklGRuQXDABXQVZF…” }, “type”: “input_audio” }, { “text”: “I used to rule the world.”, “type”: “text” } ] |
Model | string | :heavy_check_mark: | TTS model identifier | mistralai/voxtral-mini-tts-2603 |
Provider | *components.SpeechRequestProvider | :heavy_minus_sign: | Provider-specific passthrough configuration | |
ResponseFormat | *components.SpeechRequestResponseFormat | :heavy_minus_sign: | Audio output format | pcm |
Speed | *float64 | :heavy_minus_sign: | Playback speed multiplier. Only used by models that support it (e.g. OpenAI TTS). Ignored by other providers. | 1 |
Trace | *components.TraceConfig | :heavy_minus_sign: | Metadata for observability and tracing. Known keys (trace_id, trace_name, span_name, generation_name, parent_span_id) have special handling. Additional keys are passed through as custom metadata to configured broadcast destinations. | { “trace_id”: “trace-abc123”, “trace_name”: “my-app-trace” } |
User | *string | :heavy_minus_sign: | A unique identifier representing your end-user. Forwarded to Broadcast and private logging as the end-user id; never sent to the provider. | user-1234 |
Voice | *string | :heavy_minus_sign: | Voice identifier (provider-specific). | en_paul_neutral |