Create Radio-Ready
AI Music in Seconds
Transform lyrics, descriptions, and melodies into complete studio-quality tracks with natural vocals and instruments. Use via Web Studio, REST API, or your AI Assistant.
Listen to AI Generations
Real songs produced by our studio AI engines. 4 random styles picked from our 16+ library on every visit.
Professional Music Capabilities
From amateur creators to professional sound producers and developer workflows.
Text & Lyrics to Music
Write a simple vibe prompt or input full custom lyrics with Verse, Chorus, Bridge, and Outro markers. The AI produces 2 song variations per request.
Voice & Style Covers
Turn an acoustic ballad into modern synthwave, rock, or rap. Retain original song arrangement while transforming the instruments and vocal genre.
Extend & Part 2
Keep your music progressing. Pick any timestamp to continue the song, add extra verses, or build a climactic guitar solo ending.
Developer REST API
Simple standard HTTP endpoints with Bearer authentication. Create songs, check rendering status, and download audio directly in your applications.
AI Agent MCP Integration
Connect Claude Desktop, Cursor, or ChatGPT using the Model Context Protocol (MCP) server. Generate music collaboratively straight from your chat prompt.
Instant Crypto Payments
Top up generation credits automatically with USDT, Bitcoin, Ethereum, TON, and 30+ cryptocurrencies powered securely by Cryptomus.
Credit Packs & Pricing
No recurring monthly lock-in. Pay as you go with cryptocurrency. Credits never expire.
- 2 Free Credits upon signup
- Full Web Studio access
- Standard generation speed
- M4A Audio downloads
- 30 AI Track Generations
- $0.167 per song variation
- Full Commercial Rights
- Fast rendering queue
- 120 AI Track Generations
- $0.125 per song variation
- Priority generation queue
- Covers, Extends & Stems
- REST API key access
- Model Context Protocol (MCP) Server
- Agent Skill (SKILL.md) Integration
- 300 AI Track Generations
- $0.117 per song variation
- Highest priority queue
- REST API + MCP Server
- Agent Skill File (SKILL.md)
- Priority VIP support
Integrate AI Music Into Any App or Agent
Connect seamlessly via standard REST JSON APIs, direct MCP (Model Context Protocol) for AI assistants, or our drop-in Agent Skill template.
Authentication & Base URL
Authenticate all HTTP requests by sending your personal API key in the Authorization header:
https://suno.homes/api/
Core REST Endpoints
-
POST /api/generateCreate a new song from description or lyrics. Produces 2 variations. -
POST /api/coverRestyle an existing song clip with new arrangement or custom lyrics. -
GET /api/clip/:idCheck rendering progress, retrieve streaming audio URL, and stems. -
GET /api/meRetrieve remaining generation credit balance and account details.
curl https://suno.homes/api/generate \
-H "Authorization: Bearer sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"prompt": "relaxing lofi hip hop with jazz piano and rain sounds",
"title": "Midnight Rain",
"make_instrumental": true
}'
{
"status": "submitted",
"task_id": "gen_8f3d...",
"clips": [
{ "id": "2dc06f6e-...", "status": "streaming", "audio_url": "https://suno.homes/api/clip/.../audio" },
{ "id": "03ed3a7d-...", "status": "streaming", "audio_url": "https://suno.homes/api/clip/.../audio" }
]
}
Model Context Protocol (MCP)
SunoMA provides a native streamable-HTTP MCP server compliant with OAuth 2.1. This enables Claude Desktop, Cursor, VS Code (Cline / Continue), and custom AI agents to trigger music creation tools straight from conversation prompts.
claude_desktop_config.json or Cursor MCP settings:{
"mcpServers": {
"sunoma": {
"url": "https://suno.homes/mcp"
}
}
}
Agent Skill Template (SKILL.md)
A declarative Markdown skill specification equipped with instructions and endpoint definitions. It allows autonomous agents (like Claude Code, Antigravity, Cursor Agent, AutoGen, and CrewAI) to compose rhymes, manage verses/choruses, call the REST API, and return playable audio to the user.
- Download the official
SKILL.mdfile. - Drop it into your project folder:
.claude/skills/sunoma/SKILL.mdorskills/sunoma/SKILL.md. - Fill in your
API_KEYfrom the dashboard.
--- name: sunoma-music description: Create AI music (generate, cover, sample, extend) through the SunoMA gateway REST API using an API key. ---
# SunoMA Music Skill
Base URL: https://suno.homes
Auth: Authorization: Bearer {{API_KEY}}
## Direct Agent Capability:
Ask your agent:
"Compose an emotional acoustic ballad with Arabic oud
and cello about journeying through the desert, and generate it."