How do I install the Zvukogram skill?

Run npx skillmds add modbender/zvukogram in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Zvukogram safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Zvukogram?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Zvukogram free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Zvukogram?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Zvukogram by modbender — Agent Skill

Name: Zvukogram
Rating: 4.2 (5 reviews)
Author: modbender

Zvukogram

Text-to-Speech via Zvukogram API with SSML support. Use when you need to generate speech from text, create podcasts, voice notifications, or work with audio. Supports speed control, stress marks, English word transcription, and audio fragment merging.

modbender 0717f3b 10 files · 26.2 KB Updated Sep 9, 2026 12 repo stars

File contents

Zvukogram TTS

Speech generation via Zvukogram API with SSML markup support.

Requirements

To use this skill, you need:

Zvukogram API token — get it at https://zvukogram.com/
Zvukogram account email

Setup

Create file ~/.config/zvukogram/config.json:

mkdir -p ~/.config/zvukogram

{
  "token": "your_api_token_here",
  "email": "your_email@example.com"
}

Or use environment variables:

export ZVUKOGRAM_TOKEN=your_api_token_here
export ZVUKOGRAM_EMAIL=your_email@example.com

Quick Start

# Simple TTS
python3 scripts/tts.py --text "Hello, world!" --voice Алена --output hello.mp3

# With +20% speed
python3 scripts/tts.py --text "Fast text" --voice Алена --speed 1.2 --output fast.mp3

# Check balance
python3 scripts/balance.py

Features

TTS generation — text to speech
SSML support — stress marks, pauses, speed
Audio merging — combine fragments via ffmpeg
Transcription — proper pronunciation of English words

SSML Markup

Stress Marks

Use + before stressed vowel:

З+амок — stress on "a"
зам+ок — stress on "o"

Aliases (Transcription)

<sub alias="Оупен Эй Ай">OpenAI</sub>
<sub alias="Самсунг">Samsung</sub>
<sub alias="Ал+ьтман">Альтман</sub>

Speed

<prosody rate="1.2">20% faster</prosody>
<prosody rate="fast">Fast text</prosody>

Pauses

<break time="500ms"/>

Available Voices

Алена — female, neutral (recommended)
Андрей — male, neutral (recommended)
Александра — female, soft
Антон — male, business

Full list: see references/VOICES.md

Examples

See references/EXAMPLES.md for:

Dialogs and podcasts
News voiceover
Voice notifications
Long texts

Transcription

See references/TRANSCRIPTION.md for proper pronunciation:

OpenAI → Оупен Эй Ай
GPT → Джи Пи Ти
Samsung → Самсунг
Altman → Ал+ьтман

SSML Reference

See references/SSML_CHEATSHEET.md for quick tag lookup.

Troubleshooting

See references/TROUBLESHOOTING.md for:

API errors
Audio issues
Diagnostics

API Limitations

Max 1000 characters per request (/text)
Up to 1M characters via /longtext
SSML with <voice> not supported via API (web only)
For multi-voice — merge fragments

Links

API docs: https://zvukogram.com/node/api/
Voice rating: https://zvukogram.com/rating/
Support: https://t.me/zvukogram

---name: zvukogramdescription: Text-to-Speech via Zvukogram API with SSML support. Use when you need to generate speech from text, create podcasts, voice notifications, or work with audio. Supports speed control, stress marks, English word transcription, and audio fragment merging.--- # Zvukogram TTS Speech generation via Zvukogram API with SSML markup support. ## Requirements To use this skill, you need: - **Zvukogram API token** — get it at https://zvukogram.com/ - **Zvukogram account email** ### Setup Create file `~/.config/zvukogram/config.json`: ```bash mkdir -p ~/.config/zvukogram ``` ```json { "token": "your_api_token_here", "email": "your_email@example.com" } ``` Or use environment variables: ```bash export ZVUKOGRAM_TOKEN=your_api_token_here export ZVUKOGRAM_EMAIL=your_email@example.com ``` ## Quick Start ```bash # Simple TTS python3 scripts/tts.py --text "Hello, world!" --voice Алена --output hello.mp3 # With +20% speed python3 scripts/tts.py --text "Fast text" --voice Алена --speed 1.2 --output fast.mp3 # Check balance python3 scripts/balance.py ``` ## Features - **TTS generation** — text to speech - **SSML support** — stress marks, pauses, speed - **Audio merging** — combine fragments via ffmpeg - **Transcription** — proper pronunciation of English words ## SSML Markup ### Stress Marks Use `+` before stressed vowel: ``` З+амок — stress on "a" зам+ок — stress on "o" ``` ### Aliases (Transcription) ```xml OpenAI Samsung Альтман ``` ### Speed ```xml <prosody rate="1.2">20% faster</prosody> <prosody rate="fast">Fast text</prosody> ``` ### Pauses ```xml <break time="500ms"/> ``` ## Available Voices - **Алена** — female, neutral (recommended) - **Андрей** — male, neutral (recommended) - **Александра** — female, soft - **Антон** — male, business Full list: see [references/VOICES.md](references/VOICES.md) ## Examples See [references/EXAMPLES.md](references/EXAMPLES.md) for: - Dialogs and podcasts - News voiceover - Voice notifications - Long texts ## Transcription See [references/TRANSCRIPTION.md](references/TRANSCRIPTION.md) for proper pronunciation: - OpenAI → Оупен Эй Ай - GPT → Джи Пи Ти - Samsung → Самсунг - Altman → Ал+ьтман ## SSML Reference See [references/SSML_CHEATSHEET.md](references/SSML_CHEATSHEET.md) for quick tag lookup. ## Troubleshooting See [references/TROUBLESHOOTING.md](references/TROUBLESHOOTING.md) for: - API errors - Audio issues - Diagnostics ## API Limitations - Max 1000 characters per request (`/text`) - Up to 1M characters via `/longtext` - SSML with `<voice>` not supported via API (web only) - For multi-voice — merge fragments ## Links - API docs: https://zvukogram.com/node/api/ - Voice rating: https://zvukogram.com/rating/ - Support: https://t.me/zvukogram

Frequently asked questions