ai-songwriter

name	AI Songwriter
description	Generate songs via Suno AI using kie.ai API. Supports custom lyrics, extend, cover, and upload-extend modes. No browser automation needed — pure API calls.
metadata	{"openclaw":{"emoji":"🎶"}}

🎶 AI Songwriter — Suno Music via kie.ai API

Generate songs on Suno AI through the kie.ai proxy API. No browser, no captcha — just API calls.

Prerequisites

• KIE_API_KEY or SUNO_API_KEY environment variable set
• Node.js installed

Get API key from: https://kie.ai (paid API)

Setup

export KIE_API_KEY="your-key-here"
# Or
echo "KIE_API_KEY=your-key" >> ~/.suno/.env

Usage

Generate a new song (Custom mode)

node {baseDir}/scripts/generate_suno.js "Song Title" "lyrics here" "style tags"

Example:

node {baseDir}/scripts/generate_suno.js "Morning Coffee" "Wake up with the sunrise\nCoffee in my hand" "pop, acoustic, female vocals, chill"

Extend an existing song

node {baseDir}/scripts/generate_suno.js --extend <audioId> <continueAt_sec> "continuation lyrics" [model]

Create a cover

node {baseDir}/scripts/generate_suno.js --cover <audioUrl> [model]

Upload and extend

node {baseDir}/scripts/generate_suno.js --upload-extend <audioUrl> "lyrics" [model]

Parameters

Parameter	Description
Title	Song title (1st arg for generate)
Prompt/Lyrics	Song lyrics (2nd arg)
Tags	Music style tags in English, comma-separated (3rd arg)
Model	Suno model version (default: V5)

Style Tags Reference

• Genres: rock, pop, jazz, blues, electronic, hip-hop, R&B, folk, metal, country, indie
• Instruments: electric guitar, acoustic guitar, piano, synthesizer, drums, bass, violin
• Mood: energetic, emotional, melancholic, upbeat, dark, dreamy, romantic
• Vocals: male vocals, female vocals, choir, rap, whisper, powerful vocals
• Language: english, vietnamese, chinese, japanese, korean

Output

The script polls the API and prints:

• Track title
• Audio URL (direct MP3 link)
• Video URL
• Duration
• Audio ID (for extending)

Each generation produces 2 different versions of the song.

Notes

• kie.ai API is a paid service (check pricing at kie.ai)
• Default model is Suno V5
• Generation typically takes 1-3 minutes
• The script polls every 10 seconds until complete