Voice agent: spoken question in, spoken answer out, with memory
voice_agentOne turn of a voice assistant: send the user's voice note (or text), your instructions and the earlier turns; get back what was heard, a short reply, the reply spoken as MP3 (Aura-2, English or Spanish) and the updated history to send next time. Speech up to 2 minutes (MP3/WAV, or 1 MB of other formats); replies up to 600 characters. Use for voice bots in Telegram or WhatsApp, phone menus, kiosks and hands-free helpers. Example: text=What time do you open on Saturday?. Price $0.05/call via x402 USDC or a card key (/credits); failed calls free. Reads or computes only and changes nothing; each call is charged, so repeats are not free.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "voice_agent"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Absolute http(s) URL of the user's spoken turn (MP3/WAV up to 2 minutes, other formats up to 1 MB); or POST the file; or send text instead | |
| lang | No | Reply language and voice: en or es (default en) | |
| text | No | The user's turn as text (or send audio with url or a POSTed file) | |
| voice | No | Aura-2 voice for the reply (default luna for en, aquila for es) | |
| history | No | Earlier turns as a JSON array of {role, content}, as returned in history by the last call | |
| instructions | No | Who the assistant is and what it knows (up to 2,000 characters) |