| name | anicca-music-factory |
| description | Generate AI meditation/ambient music for Anicca's Spotify catalog using apiframe.ai (Suno V5). Use when the user says "make music", "generate a track", "create meditation song", "音楽作って", "瞑想音楽生成", or wants to add to the Anicca Sounds / 無常 Mujō / Bodhi Frequencies catalog before manual DistroKid upload. |
Anicca Music Factory
Manual on-demand skill that generates AI music for Anicca's Spotify monetization catalog. Targets the meditation/ambient niche where passive listening drives long stream times and high per-track royalties.
Strategy reference: see strategy.md in this directory for the full Spotify monetization playbook copied from the Telisha Jones / James 99 case studies.
Personas (artist names)
| Persona | Niche | Suno tags | Target market |
|---|
| Anicca Sounds | English meditation, deep ambient | meditation, ambient, deep relaxation, soft drone | Western Spotify |
| 無常 Mujō | Japanese / Tibetan, traditional instruments | tibetan singing bowls, koto, shakuhachi, zen meditation | JP + global meditation |
| Bodhi Frequencies | Binaural / healing frequencies | 528hz, binaural beats, brainwave entrainment, healing | Sleep / focus listeners |
Pick one persona per generation run. Multiple personas = wider Spotify algorithmic reach (article law #5).
Authentication
Requires apiframe.ai API key in environment.
export APIFRAME_API_KEY="<key from ~/.openclaw/.env>"
If APIFRAME_API_KEY is unset, source the env file first:
source ~/.openclaw/.env
NEVER hardcode the key in any file. NEVER echo it. NEVER commit it.
API Reference (apiframe.ai → Suno V5)
Base URL: https://api.apiframe.pro
1. Generate music (POST /suno-imagine)
curl -X POST https://api.apiframe.pro/suno-imagine \
-H "Authorization: $APIFRAME_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "deep ambient meditation, tibetan singing bowls, slow drone, impermanence theme, 8 minutes",
"model": "V5",
"make_instrumental": true,
"title": "Returning to Stillness",
"tags": "meditation, ambient, tibetan bowls, healing"
}'
Response:
{ "task_id": "abc123..." }
Suno V5 generates 2 variations per call (audio_a + audio_b). Pick the better one or release both.
2. Poll for completion (POST /fetch)
curl -X POST https://api.apiframe.pro/fetch \
-H "Authorization: $APIFRAME_API_KEY" \
-H "Content-Type: application/json" \
-d '{"task_id": "abc123..."}'
Poll every 15 seconds until status == "finished". Typical completion: 30-90 seconds.
Response (finished):
{
"status": "finished",
"task_type": "suno",
"percentage": 100,
"songs": [
{
"song_id": "da7f...",
"lyrics": "[Instrumental]",
"duration": 179.84,
"audio_url": "https://cdn.apiframe.pro/songs/...-1.mp3",
"image_url": "https://musicfile.kie.ai/...jpeg"
},
{
"song_id": "bb34...",
"lyrics": "[Instrumental]",
"duration": 154.92,
"audio_url": "https://cdn.apiframe.pro/songs/...-2.mp3",
"image_url": "https://musicfile.kie.ai/...jpeg"
}
]
}
Suno V5 returns 2 variations in songs[] array (typical duration: 2:30-3:30 each). For longer tracks (8+ minutes), call the EXTEND endpoint with the chosen song_id.
Output structure (versioned, never overwrite)
/Users/anicca/anicca-project/music-factory/
└── {persona-slug}/ # anicca-sounds | mujo | bodhi-frequencies
└── {YYYY-MM-DD}/ # 2026-04-28
└── v{N}/ # v1, v2, v3, ... (NEVER overwrite)
├── metadata.json # title, tags, prompt, persona, ISRC-pending
├── audio_a.mp3
├── audio_b.mp3
└── cover.jpg # downloaded from Suno
metadata.json schema:
{
"persona": "Anicca Sounds",
"title": "Returning to Stillness",
"tags": "meditation, ambient, tibetan bowls",
"prompt": "deep ambient meditation, tibetan singing bowls...",
"model": "V5",
"instrumental": true,
"duration_a_seconds": 240,
"duration_b_seconds": 245,
"generated_at": "2026-04-28T14:00:00+09:00",
"task_id": "abc123...",
"distrokid_uploaded": false,
"spotify_url": null,
"isrc": null,
"stream_count_30d": null
}
Workflow when invoked
When the user says "make music" / "音楽作って" / "generate meditation track":
Step 1 — Confirm persona + theme
Ask the user (one question only) which persona to use, OR pick by inference:
- "瞑想" / "ambient" → Anicca Sounds
- "和" / "tibetan" / "koto" → 無常 Mujō
- "528hz" / "binaural" / "frequency" → Bodhi Frequencies
If unclear, default to Anicca Sounds (broadest market).
Step 2 — Generate prompt + title
Use the persona's tag set + Anicca's impermanence theme. Examples:
| Persona | Prompt template |
|---|
| Anicca Sounds | "deep ambient meditation, soft synth pads, slow drone, contemplating impermanence, 8 minutes, no vocals" |
| 無常 Mujō | "tibetan singing bowls, shakuhachi flute, zen garden, slow tempo, mujō meditation, 7 minutes" |
| Bodhi Frequencies | "528hz healing frequency, binaural beats, ambient pads, deep relaxation, 10 minutes" |
Title: short, evocative, English (better Spotify search). Examples: "Returning to Stillness", "Empty Mountain", "528 Hz Awakening", "Mujō", "The River That Was".
Step 3 — Call apiframe Suno
POST /suno-imagine with the params above.
Get task_id.
Step 4 — Poll until finished
Poll /fetch every 15 seconds. Hard timeout: 5 minutes.
Step 5 — Download + save
PERSONA_SLUG="anicca-sounds"
DATE=$(date +%Y-%m-%d)
BASE="/Users/anicca/anicca-project/music-factory/${PERSONA_SLUG}/${DATE}"
mkdir -p "$BASE"
N=1
while [ -d "$BASE/v$N" ]; do N=$((N+1)); done
DIR="$BASE/v$N"
mkdir -p "$DIR"
curl -L "$AUDIO_URL_A" -o "$DIR/audio_a.mp3"
curl -L "$AUDIO_URL_B" -o "$DIR/audio_b.mp3"
curl -L "$IMAGE_URL" -o "$DIR/cover.jpg"
Step 6 — Report
Tell the user:
- Where the files are
- Title, persona, tags
- Next manual step: upload to DistroKid → Spotify
Cost reference
| Plan (apiframe.ai) | Price | Credits/month | Suno V5 songs/month |
|---|
| Free | $0 | 20 | ~4 (testing only) |
| Basic | $19/mo (yearly $39 first month) | 1,000 | ~200 |
| Starter | $99/mo | 5,500 | ~1,100 |
Source: https://apiframe.ai/pricing (verified 2026-04-28)
Each Suno V5 IMAGINE call = ~5 credits (2 audio variations). Confirm exact cost in apiframe dashboard after first call.
Distribution (manual phase)
After generation, the user uploads manually to DistroKid → Spotify:
- Login: https://distrokid.com (Musician plan $24.99/year)
- Upload → New Single
- Artist name = persona (Anicca Sounds / 無常 Mujō / Bodhi Frequencies)
- Song title = from
metadata.json
- Audio file =
audio_a.mp3 (or audio_b.mp3)
- Cover =
cover.jpg
- Genre = Ambient / New Age / Meditation
- Confirm "I declare this is AI-generated" (Spotify 2025 rule)
- Submit → typical 1-3 days to appear on Spotify
Update metadata.json after upload:
{ "distrokid_uploaded": true, "isrc": "...", "spotify_url": "..." }
Automation upgrade trigger
When the user reports >$500/month Spotify royalties, upgrade this skill to:
- Cron: 04:00 JST daily
- Playwright DistroKid auto-upload
- Spotify for Artists API analytics ingest
- Slack #metrics report
Until then: stay manual. Don't burn money on cron-generated unsold catalog.
Article strategy (Spotify monetization laws)
See strategy.md for full analysis. Core laws:
| # | Law |
|---|
| 1 | Pick passive-listening niches (meditation, sleep, lo-fi). Avoid pop. |
| 2 | Volume > quality. 80-track catalog earns more than 8. |
| 3 | Consistent release cadence (weekly). Spotify rewards "active artist". |
| 4 | Doubling down on hits. When one track gets traction, generate similar. |
| 5 | Multiple personas. Each persona = different niche = wider reach. |
Compliance notes
- Spotify AI disclosure (2025): All AI-generated tracks must be declared. DistroKid has a checkbox.
- Suno lawsuit (ongoing): Major labels suing. Apiframe.ai uses Suno via API; legal risk passes through. Monitor news.
- Spotify removed 75M AI tracks in 2025: Most were spam/duplicate. Original tracks with proper metadata survive.
Files in this skill
| File | Purpose |
|---|
SKILL.md | This file. Main instructions Claude reads when invoked. |
strategy.md | Full article + 5 monetization laws + Anicca brand alignment. |
scripts/generate.sh | Bash script implementing the full flow (Step 1-6 above). |
