VoxFlow Podcast Skill

Generate multi-speaker AI podcasts entirely from the command line. Sister skills:

• Simple TTS / narration / voice search → voxflow (hub)
• Short videos / AI clips / knowledge cards → voxflow:video
• Transcribe / translate subtitles / dub → voxflow:transcribe

Prerequisites

• Node.js ^20.19.0 || >=22.12.0
• npm install -g voxflow then voxflow login
• VoxFlow account (free tier: 10K quota/month)

No API keys needed — all auth goes through voxflow login.

Quick Start

# 1. Login (one-time, opens browser)
voxflow login

# 2. Generate a podcast
voxflow podcast --topic "AI 时代的程序员出路"

# 3. Output: podcast-2026-03-20T12-00-00.wav + .txt

Full Workflow

Step 1: Generate Script Only

voxflow podcast \
  --topic "量子计算入门" \
  --template tutorial \
  --colloquial medium \
  --speakers 2 \
  --language zh-CN \
  --format json \
  --no-tts

Outputs: podcast-<ts>.txt + podcast-<ts>.podcast.json

Step 2: Review & Edit

Open .podcast.json — it contains structured dialogue, speaker info, quality scores, and voice mappings. Edit as needed.

Step 3: Synthesize from File

voxflow podcast --input podcast-2026-03-20.podcast.json --output final.wav

One-Shot (generate + synthesize)

voxflow podcast \
  --topic "Web3 的未来" \
  --engine ai-sdk \
  --colloquial high \
  --speakers 3 \
  --output web3-podcast.wav

Parameters

Engine Comparison

Templates

• interview — Host + Guest deep conversation
• discussion — Roundtable multi-person discussion
• news — Professional news briefing
• story — Multi-character story narration
• tutorial — Teacher + Student educational dialogue

Quota Cost

Per-turn TTS call count depends on voice: voices flagged nativePauseSupported: true (most podcast voices) take 1 TTS call per turn — TRTC honors <|break|> / <|s_break|> markers natively (~250-430ms inserted). Voices that haven't been verified (e.g. 旁白 narration voices) fall back to client-side splice = N calls per turn.

Typical medium podcast (16 turns, all native voices) ≈ 16 × 50 + 2,000 = 2,800 quota — Free tier (10K/month) covers ~3 medium podcasts. Tip: if you already have a script, pass --script my.json to skip the 2,000 LLM step entirely. Mixed-voice podcasts cost slightly more if they include non-native voices.

Examples

# English tech podcast
voxflow podcast --topic "AI ethics debate" --language en --template discussion

# Quick news briefing (short)
voxflow podcast --topic "本周科技新闻" --template news --length short

# Casual chat with high colloquial level
voxflow podcast --topic "程序员加班那些事" --colloquial high

# JSON export for editing
voxflow podcast --topic "创业故事" --format json --no-tts

# Synthesize edited script
voxflow podcast --input edited-podcast.podcast.json --speed 1.1

Rules

1. Check quota first — medium podcast ≈ 5K. Run voxflow status before generation.
2. Iterate on the script — use --no-tts --format json to inspect dialogue before paying for TTS.
3. Voice mapping — for ai-sdk engine, the .podcast.json includes per-speaker voice IDs. Edit them before re-running with --input.
4. Auto-play when done: open podcast-*.wav.