iliad_text_to_speech
ActiveTool of AXIS Toolbox — Agentic Commerce Codebase Intelligence
AXIS-owned voice synthesis via Piper (rhasspy/piper) + ffmpeg-static. Accepts `text` (1-5000 chars), optional `voice` slug (filename without extension; defaults to AXIS_PIPER_DEFAULT_VOICE or the first available voice), optional `format` (wav | mp3 | opus; defaults wav), optional `sentence_silence` (0-5 seconds, default 0.2). Returns `{audio_base64, format, voice_used, sample_rate, duration_seconds, byte_size}`. Inference is fully in-process — no upstream provider, no per-character fee. When operator hasn't installed piper or placed voice .onnx + .onnx.json files in AXIS_PIPER_VOICE_DIR (default models/piper/), returns `{_not_configured: true, reason, detail, remediation}`. format=mp3/opus additionally requires ffmpeg-static. Engineer mode (X-Agent-Mode: engineer — Brand Voice, $0.10): pass `brand_text` (a brand / voice-and-tone artifact) and AXIS auto-derives the voice persona (Piper voice slug + sentence pacing) and synthesizes in it; the persona is echoed in the response. Requires Authorization: Bearer <api_key>.
Parameters schema
{
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"description": "Text to speak. 1-5000 chars after trim."
},
"voice": {
"type": "string",
"description": "Voice slug (filename without extension, e.g. 'en_US-amy-medium'). Defaults to first available voice or AXIS_PIPER_DEFAULT_VOICE."
},
"format": {
"enum": [
"wav",
"mp3",
"opus"
],
"type": "string",
"description": "Audio codec."
},
"gender": {
"enum": [
"female",
"male"
],
"type": "string",
"description": "Engineer mode: persona gender override."
},
"locale": {
"enum": [
"us",
"gb"
],
"type": "string",
"description": "Engineer mode: persona locale override."
},
"brand_text": {
"type": "string",
"description": "Engineer mode: brand / voice-and-tone artifact. AXIS derives a voice persona from it and synthesizes in that voice (overrides voice/sentence_silence)."
},
"sentence_silence": {
"type": "number",
"description": "Per-sentence silence in seconds (0-5). Defaults 0.2."
}
}
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
AXIS Toolbox — Agentic Commerce Codebase Intelligence
https://github.com/lastmanupinc-hub/Toolbox
1/7 registries