TTSConfig
Cartesia Sonic-3 TTS configuration
Usage profiles
| Usage | Fields and validation |
|---|---|
| In requests | View fields |
In requests
API JSON uses JSON field names (camelCase).
| Field | Type | Presence | Meaning |
|---|---|---|---|
voiceId | string | Required in requests | Provider-specific voice identifier (Cartesia voice_id) Minimum length: 1. |
model | string | Optional | Optional Cartesia model identifier (e.g., "sonic-english") |
sampleRate | integer (int32) | Optional | Optional sample rate override (Hz) Minimum: -2147483648. Maximum: 2147483647. |
volume | number (double) | Required in requests | Volume multiplier (0.5..2.0) Minimum: 0.5. Maximum: 2. |
speed | number (double) | Required in requests | Speed multiplier (0.6..1.5) Minimum: 0.6. Maximum: 1.5. |
emotion | string | Optional | Single emotion string (e.g., "neutral", "excited") |
language | string | Optional | Cartesia language code (e.g., "EN") |
Request validation
These rules apply when this value is supplied in a request. Request validation does not guarantee that response fields are present or satisfy the same rules.
| Applies to | Rule | Requirement |
|---|---|---|
voiceId | Minimum length | 1 |
volume | At most | 2 |
volume | At least | 0.5 |
speed | At most | 1.5 |
speed | At least | 0.6 |
Where used
| Reference | Relationship |
|---|---|
| Create a voice session (in progress) | POST /api/v1/llm/create-daily-session |
| SocayoAgentConfig | Nested in model |
Download the public reference contract.
Document: DOC-API-MODEL-tts-config.