Audio Cog - AI Audio Generation Powered by CellCog
Create professional audio with AI - from voiceovers and narration to background music and sound design.
Prerequisites
This skill requires the cellcog skill for SDK setup and API calls.
clawhub install cellcog
Read the cellcog skill first for SDK setup. This skill shows you what's possible.
Quick pattern (v1.0+):
# Fire-and-forget - returns immediately
result = client.create_chat(
prompt="[your audio request]",
notify_session_key="agent:main:main",
task_label="audio-task",
chat_mode="agent" # Agent mode is optimal for all audio tasks
)
# Daemon notifies you when complete - do NOT poll
What Audio You Can Create
Text-to-Speech / Voiceover
Convert text to natural-sounding speech:
- Narration: "Generate a professional male voiceover for this product video script"
- Audiobook Style: "Create an engaging narration of this short story with emotional delivery"
- Podcast Intros: "Generate a warm, friendly podcast intro: 'Welcome to The Daily Tech...'"
- E-Learning: "Create clear, instructional voiceover for this training module"
- IVR/Phone Systems: "Generate professional phone menu prompts"
Available Voices
CellCog provides 8 high-quality voices with distinct characteristics:
| Voice |
Gender |
Best For |
Characteristics |
| cedar |
Male |
Product videos, announcements |
Warm, resonant, authoritative, trustworthy |
| marin |
Female |
Professional content, tutorials |
Bright, articulate, emotionally agile |
| ballad |
Male |
Storytelling, flowing narratives |
Smooth, melodic, musical quality |
| coral |
Female |
Energetic content, ads |
Vibrant, lively, dynamic, spirited |
| echo |
Male |
Thoughtful content, documentaries |
Calm, measured, deliberate |
| sage |
Female |
Educational, knowledge content |
Wise, contemplative, reflective |
| shimmer |
Female |
Gentle content, wellness |
Soft, gentle, soothing, approachable |
| verse |
Male |
Creative, artistic content |
Poetic, rhythmic, expressive |
Voice Recommendations by Use Case
For product videos and announcements:
Use cedar (male) or marin (female) - both project confidence and professionalism.
For storytelling and audiobooks:
Use ballad (male) or sage (female) - designed for engaging, flowing narratives.
For high-energy content:
Use coral (female) - vibrant and dynamic, perfect for ads and exciting announcements.
For calm, educational content:
Use echo (male) or shimmer (female) - measured pacing ideal for learning.
Voice Style Customization
Beyond selecting a voice, you can fine-tune delivery with style instructions:
- Accent & dialect: American, British, Australian, Indian, etc.
- Emotional range: Excited, serious, warm, mysterious, dramatic
- Pacing: Slow and deliberate, conversational, fast and energetic
- Special effects: Whispering, character impressions
Example with style instructions:
"Generate voiceover using cedar voice with a warm, conversational tone. Speak at medium pace with slight enthusiasm when mentioning features. American accent."
Music Generation
Create original background music and soundtracks:
- Background Music: "Create calm lo-fi background music for a study video, 2 minutes"
- Podcast Music: "Generate an upbeat intro jingle for a tech podcast, 15 seconds"
- Video Soundtracks: "Create cinematic orchestral music for a product launch video"
- Ambient/Mood: "Generate peaceful ambient sounds for a meditation app"
- Genre-Specific: "Create energetic electronic music for a fitness video"
Music Specifications
| Parameter |
Options |
| Duration |
15 seconds to 5+ minutes |
| Genre |
Electronic, rock, classical, jazz, ambient, lo-fi, cinematic, pop, hip-hop |
| Tempo |
60 BPM (slow) to 180+ BPM (fast) |
| Mood |
Upbeat, calm, dramatic, mysterious, inspiring, melancholic |
| Instruments |
Piano, guitar, synth, strings, drums, brass, etc. |
Music Licensing
All AI-generated music from CellCog is royalty-free and fully yours to use commercially.
You have complete rights to use the generated music for:
- YouTube videos (including monetized content)
- Commercial projects and advertisements
- Podcasts and streaming
- Apps and games
- Any other commercial or personal use
No attribution required. No licensing fees. The music is generated uniquely for you.
Audio Output Formats
| Format |
Best For |
| MP3 |
Standard audio delivery, voiceovers, music |
| Combined with video |
Background music for video-cog outputs |
Chat Mode for Audio
Use chat_mode="agent" for all audio generation tasks.
Audio generation—whether voiceovers, music, or sound design—executes efficiently in agent mode. CellCog's audio capabilities don't require multi-angle deliberation; they require precise execution, which agent mode excels at.
There's no scenario where agent team mode provides meaningfully better audio output. Save agent team for research and complex creative work that benefits from multiple reasoning passes.
Example Audio Prompts
Professional voiceover with specific voice:
"Generate a professional voiceover using the marin voice for this script:
'Introducing TaskFlow - the project management tool that actually works. With intelligent automation, seamless collaboration, and powerful analytics, TaskFlow helps teams do their best work.'
Style: Confident and friendly, medium pace. Suitable for a product launch video."
Podcast intro with voice selection:
"Create a podcast intro voiceover using cedar voice:
'Welcome to Future Forward, the podcast where we explore the technologies shaping tomorrow. I'm your host, and today we're diving into...'
Style: Warm and engaging, conversational tone. Also generate a 10-second upbeat intro music bed to go underneath."
Background music:
"Generate 2 minutes of calm, lo-fi hip-hop style background music. Should be chill and unobtrusive, good for studying or working. Include soft piano, mellow beats, and gentle vinyl crackle. 75 BPM."
Audiobook narration:
"Create an audiobook-style narration using ballad voice for this passage:
[passage text]
Style: Warm storytelling quality, measured pace with appropriate pauses for drama."
Cinematic music:
"Generate 90 seconds of cinematic orchestral music for a tech company's 'About Us' video. Start soft and inspiring, build to a confident crescendo, then resolve to a hopeful ending."
Multi-Language Support
CellCog can generate speech in 50+ languages:
- English (multiple accents)
- Spanish, French, German, Italian, Portuguese
- Chinese (Mandarin, Cantonese)
- Japanese, Korean
- Hindi, Arabic
- Russian, Polish, Dutch
- And many more
Specify the language in your prompt:
"Generate this text in Japanese with a native female speaker using shimmer voice: 'いらっしゃいませ...'"
Tips for Better Audio
Choose the right voice: Match the voice to your content type. Cedar/marin for professional, ballad/sage for storytelling, coral for energy.
Provide the complete script: Don't say "something about our product" - write out exactly what should be said.
Include style instructions: "Confident but warm", "slow and deliberate", "with slight excitement" helps shape delivery.
For music: Specify duration, tempo (BPM if you know it), mood, and genre.
Pronunciation guidance: For names or technical terms, add hints: "CellCog (pronounced SELL-kog)"
Emotional beats: For longer voiceovers, indicate tone shifts: "[excited] And now for the big reveal... [serious] But there's a catch."
1---2name: audio-cog3description: AI audio generation powered by CellCog. Text-to-speech, voice synthesis, voiceovers, podcast audio, narration, music generation, background music, sound design. Professional audio creation with AI.4---5
6# Audio Cog - AI Audio Generation Powered by CellCog
7
8Create professional audio with AI - from voiceovers and narration to background music and sound design.
9
10---
11
12## Prerequisites
13
14This skill requires the `cellcog` skill for SDK setup and API calls.
15
16```bash
17clawhub install cellcog
18```
19
20**Read the cellcog skill first** for SDK setup. This skill shows you what's possible.
21
22**Quick pattern (v1.0+):**
23```python
24# Fire-and-forget - returns immediately
25result = client.create_chat(
26 prompt="[your audio request]",
27 notify_session_key="agent:main:main",
28 task_label="audio-task",
29 chat_mode="agent" # Agent mode is optimal for all audio tasks
30)
31# Daemon notifies you when complete - do NOT poll
32```
33
34---
35
36## What Audio You Can Create
37
38### Text-to-Speech / Voiceover
39
40Convert text to natural-sounding speech:
41
42- **Narration**: "Generate a professional male voiceover for this product video script"
43- **Audiobook Style**: "Create an engaging narration of this short story with emotional delivery"
44- **Podcast Intros**: "Generate a warm, friendly podcast intro: 'Welcome to The Daily Tech...'"
45- **E-Learning**: "Create clear, instructional voiceover for this training module"
46- **IVR/Phone Systems**: "Generate professional phone menu prompts"
47
48---
49
50## Available Voices
51
52CellCog provides 8 high-quality voices with distinct characteristics:
53
54| Voice | Gender | Best For | Characteristics |
55|-------|--------|----------|-----------------|
56| **cedar** | Male | Product videos, announcements | Warm, resonant, authoritative, trustworthy |
57| **marin** | Female | Professional content, tutorials | Bright, articulate, emotionally agile |
58| **ballad** | Male | Storytelling, flowing narratives | Smooth, melodic, musical quality |
59| **coral** | Female | Energetic content, ads | Vibrant, lively, dynamic, spirited |
60| **echo** | Male | Thoughtful content, documentaries | Calm, measured, deliberate |
61| **sage** | Female | Educational, knowledge content | Wise, contemplative, reflective |
62| **shimmer** | Female | Gentle content, wellness | Soft, gentle, soothing, approachable |
63| **verse** | Male | Creative, artistic content | Poetic, rhythmic, expressive |
64
65### Voice Recommendations by Use Case
66
67**For product videos and announcements:**
68> Use **cedar** (male) or **marin** (female) - both project confidence and professionalism.
69
70**For storytelling and audiobooks:**
71> Use **ballad** (male) or **sage** (female) - designed for engaging, flowing narratives.
72
73**For high-energy content:**
74> Use **coral** (female) - vibrant and dynamic, perfect for ads and exciting announcements.
75
76**For calm, educational content:**
77> Use **echo** (male) or **shimmer** (female) - measured pacing ideal for learning.
78
79### Voice Style Customization
80
81Beyond selecting a voice, you can fine-tune delivery with style instructions:
82
83- **Accent & dialect**: American, British, Australian, Indian, etc.
84- **Emotional range**: Excited, serious, warm, mysterious, dramatic
85- **Pacing**: Slow and deliberate, conversational, fast and energetic
86- **Special effects**: Whispering, character impressions
87
88**Example with style instructions:**
89> "Generate voiceover using cedar voice with a warm, conversational tone. Speak at medium pace with slight enthusiasm when mentioning features. American accent."
90
91---
92
93## Music Generation
94
95Create original background music and soundtracks:
96
97- **Background Music**: "Create calm lo-fi background music for a study video, 2 minutes"
98- **Podcast Music**: "Generate an upbeat intro jingle for a tech podcast, 15 seconds"
99- **Video Soundtracks**: "Create cinematic orchestral music for a product launch video"
100- **Ambient/Mood**: "Generate peaceful ambient sounds for a meditation app"
101- **Genre-Specific**: "Create energetic electronic music for a fitness video"
102
103### Music Specifications
104
105| Parameter | Options |
106|-----------|---------|
107| **Duration** | 15 seconds to 5+ minutes |
108| **Genre** | Electronic, rock, classical, jazz, ambient, lo-fi, cinematic, pop, hip-hop |
109| **Tempo** | 60 BPM (slow) to 180+ BPM (fast) |
110| **Mood** | Upbeat, calm, dramatic, mysterious, inspiring, melancholic |
111| **Instruments** | Piano, guitar, synth, strings, drums, brass, etc. |
112
113### Music Licensing
114
115**All AI-generated music from CellCog is royalty-free and fully yours to use commercially.**
116
117You have complete rights to use the generated music for:
118- YouTube videos (including monetized content)
119- Commercial projects and advertisements
120- Podcasts and streaming
121- Apps and games
122- Any other commercial or personal use
123
124No attribution required. No licensing fees. The music is generated uniquely for you.
125
126---
127
128## Audio Output Formats
129
130| Format | Best For |
131|--------|----------|
132| **MP3** | Standard audio delivery, voiceovers, music |
133| Combined with video | Background music for video-cog outputs |
134
135---
136
137## Chat Mode for Audio
138
139**Use `chat_mode="agent"`** for all audio generation tasks.
140
141Audio generation—whether voiceovers, music, or sound design—executes efficiently in agent mode. CellCog's audio capabilities don't require multi-angle deliberation; they require precise execution, which agent mode excels at.
142
143There's no scenario where agent team mode provides meaningfully better audio output. Save agent team for research and complex creative work that benefits from multiple reasoning passes.
144
145---
146
147## Example Audio Prompts
148
149**Professional voiceover with specific voice:**
150> "Generate a professional voiceover using the **marin** voice for this script:
151>
152> 'Introducing TaskFlow - the project management tool that actually works. With intelligent automation, seamless collaboration, and powerful analytics, TaskFlow helps teams do their best work.'
153>
154> Style: Confident and friendly, medium pace. Suitable for a product launch video."
155
156**Podcast intro with voice selection:**
157> "Create a podcast intro voiceover using **cedar** voice:
158>
159> 'Welcome to Future Forward, the podcast where we explore the technologies shaping tomorrow. I'm your host, and today we're diving into...'
160>
161> Style: Warm and engaging, conversational tone. Also generate a 10-second upbeat intro music bed to go underneath."
162
163**Background music:**
164> "Generate 2 minutes of calm, lo-fi hip-hop style background music. Should be chill and unobtrusive, good for studying or working. Include soft piano, mellow beats, and gentle vinyl crackle. 75 BPM."
165
166**Audiobook narration:**
167> "Create an audiobook-style narration using **ballad** voice for this passage:
168>
169> [passage text]
170>
171> Style: Warm storytelling quality, measured pace with appropriate pauses for drama."
172
173**Cinematic music:**
174> "Generate 90 seconds of cinematic orchestral music for a tech company's 'About Us' video. Start soft and inspiring, build to a confident crescendo, then resolve to a hopeful ending."
175
176---
177
178## Multi-Language Support
179
180CellCog can generate speech in 50+ languages:
181
182- English (multiple accents)
183- Spanish, French, German, Italian, Portuguese
184- Chinese (Mandarin, Cantonese)
185- Japanese, Korean
186- Hindi, Arabic
187- Russian, Polish, Dutch
188- And many more
189
190Specify the language in your prompt:
191> "Generate this text in Japanese with a native female speaker using shimmer voice: 'いらっしゃいませ...'"
192
193---
194
195## Tips for Better Audio
196
1971. **Choose the right voice**: Match the voice to your content type. Cedar/marin for professional, ballad/sage for storytelling, coral for energy.
198
1992. **Provide the complete script**: Don't say "something about our product" - write out exactly what should be said.
200
2013. **Include style instructions**: "Confident but warm", "slow and deliberate", "with slight excitement" helps shape delivery.
202
2034. **For music**: Specify duration, tempo (BPM if you know it), mood, and genre.
204
2055. **Pronunciation guidance**: For names or technical terms, add hints: "CellCog (pronounced SELL-kog)"
206
2076. **Emotional beats**: For longer voiceovers, indicate tone shifts: "[excited] And now for the big reveal... [serious] But there's a catch."