Speak a line
voice_speakSynthesises a line of English as a 44.1 kHz WAV with the engine's own voice. The voices are synthesised by the engine, never cloned from a recording, and no voice can be uploaded. seed varies the voice; woman, age (0 to 1) and machine shape it; speed (0.5 to 2) sets how fast it speaks (1 is the speaker's own); rate sets the sample rate. Every line comes back at one loudness (level_db, default -16 dBFS of speech, so lines from different voices sit together on a timeline and none clips; level_db false leaves the voice's own level) and with its silence trimmed to a breath either side (trim false keeps the voice's half-second tail). text is at most 1000 characters, and a line that presents itself as spoken by a real, famous person is refused. Costs 1 unit.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"text": "<text>"
},
"name": "voice_speak"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| age | No | How old the voice sounds, 0 (young) to 1 (old). | |
| rate | No | Sample rate in hertz: 16000, 22050, 44100 or 48000. | |
| seed | No | A whole number that varies the voice. | |
| text | Yes | The English line to speak, at most 1000 characters. A line that presents itself as spoken by a real, famous person is refused. | |
| trim | No | False to keep the voice's half-second silent tail; the default trims silence to a breath either side. | |
| speed | No | How fast it speaks, 0.5 to 2; 1 is the speaker's own pace. | |
| woman | No | True for a woman's voice, false for a man's. | |
| machine | No | True to give the voice a machine quality. | |
| level_db | No | Loudness in dBFS of speech, -30 to -6 (default -16); false leaves the voice's own level. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ms | No | Milliseconds the run took. | |
| job | Yes | The job id; the job tool reads it. | |
| verb | No | The tool that made it. | |
| files | No | Files made, each with a name, type, size and a signed URL. | |
| units | No | Units this call cost. | |
| result | No | The engine's own answer, a JSON document. | |
| status | No | queued when the job runs in the background. |