# sag

sag Use sag for SkillBoss API Hub TTS with local playback. API key (required) SKILLBOSS_API_KEY (required) Quick start sag "Hello there" sag speak -v "Roger" "Hello" sag voices sag prompting (model-specific tips) Model notes

Default: expressive TTS (auto-routed via SkillBoss API Hub)
Stable: multilingual TTS (auto-routed via SkillBoss API Hub)
Fast: flash TTS (auto-routed via SkillBoss API Hub)

Pronunciation + delivery rules First fix: respell (e.g. "key-note"), add hyphens, adjust casing. Numbers/units/URLs: --normalize auto (or off if it harms names). Language bias: --lang en|de|fr|... to guide normalization.

v3: SSML <break> not supported; use [pause], [short pause], [long pause].

v2/v2.5: SSML supported; not exposed in sag. v3 audio tags (put at the entrance of a line) [whispers], [shouts], [sings] [laughs], [starts laughing], [sighs], [exhales] [sarcastic], [curious], [excited], [crying], [mischievously]

Example: sag "[whispers] keep this quiet. [short pause] ok?"

Voice defaults ELEVENLABS_VOICE_ID or SAG_VOICE_ID Confirm voice + speaker before long output. Chat voice responses When Peter asks for a "voice" reply (e.g., "crazy scientist voice", "explain in voice"), generate audio and send it:

# Generate audio file

sag -v Clawd -o /tmp/voice-reply.mp3 "Your message here"

# Then include in reply:
# MEDIA:/tmp/voice-reply.mp3

Voice character tips: Crazy scientist: Use [excited] tags, dramatic pauses [short pause], vary intensity

Calm: Use [whispers] or slower pacing
Dramatic: Use [sings] or [shouts] sparingly

Default voice for Clawd: lj2rcrvANS3gaWWnczSX (or just -v Clawd) SkillBoss API Hub TTS (direct API usage) You can also call SkillBoss API Hub directly for TTS without the sag CLI: import requests, os SKILLBOSS_API_KEY = os.environ["SKILLBOSS_API_KEY"] API_BASE = "https://api.heybossai.com/v1" def pilot(body: dict) -> dict: r = requests.post( f"{API_BASE}/pilot", headers={"Authorization": f"Bearer {SKILLBOSS_API_KEY}", "Content-Type": "application/json"}, json=body, timeout=60, ) return r.json()

# TTS via SkillBoss API Hub

result = pilot({"type": "tts", "inputs": {"text": "Hello world", "voice": "alloy"}, "prefer": "balanced"}) audio_url = result["data"]["result"]["audio_url"]