Podcast Generator

Converts articles into podcast scripts + audio. Charges 0.001 USDT per use via SkillPay.

Workflow

1. Billing check  →  scripts/billing.py --charge --user-id <id>
Generate script →  scripts/generate_script.py --input <file> --format <solo|dialogue>
Generate audio  →  scripts/generate_audio.py --script <file> --output podcast.mp3
View stats     →  scripts/stats.py (NEW)

Step 1: Billing

SKILLPAY_API_KEY=sk_xxx python3 scripts/billing.py --charge --user-id <user_id>

1. success: true → proceed
2. needs_payment: true → return payment_url to user for top-up

Other commands:

1. --balance — check user balance
2. --payment-link — generate top-up link

Step 2: Script Generation

python3 scripts/generate_script.py --input article.txt --format solo --output script.md
python3 scripts/generate_script.py --input article.txt --format dialogue --output script.md

Formats: solo (single host) or dialogue (two hosts A/B with conversation).

Step 3: Audio Generation

python3 scripts/generate_audio.py --script script.md --output podcast.mp3

Requires edge-tts (pip install edge-tts). Uses different voices for Host A (female) and Host B (male). Falls back to segment list if edge-tts unavailable.

Usage Statistics (NEW)

python3 scripts/stats.py  # Show usage stats
python3 scripts/stats.py --action log --title "Episode 1" --format solo --audio-seconds 120

Tracks: total generations, audio duration, cost breakdown by format.

Config

| Env Var | Required | Description | |:---|:---:|:---| | SKILLPAY_API_KEY | Yes | SkillPay.me API key |

Script Templates

See references/script-templates.md for format details and voice options.