Suno
AI music generation — create full songs with vocals, instruments, and lyrics from a text prompt.
# Works with Claude Code, Codex, Gemini CLI, Cursor, and 50+ agents
npx skills add runapi-ai/suno -gInstall the Suno skill for me: 1. Clone https://github.com/runapi-ai/suno 2. Copy the skills/suno/ directory into your user-level skills directory (e.g. ~/.claude/skills/ for Claude Code, ~/.codex/skills/ for Codex). 3. Verify that SKILL.md is present. 4. Confirm the install path when done.
Suno generates complete songs from text prompts, including vocals, instrumentation, and lyrics. It spans V3.5 through V5.5, with each generation producing broadcast-ready tracks across any musical genre.
- Installable agent skill
- Unified API key
- SDK examples included
- Fehlgeschlagene Generierungen werden nicht berechnet
Varianten
Utility endpoints
Shared endpoints for this model line, such as extension, enhancement, or conversion actions.
Use this model from your agent
# User prompt to the agent
"Write a lo-fi chill beat with soft piano, vinyl crackle, and a gentle bass line, 2 minutes long."// Code generated by the agent via @runapi.ai/suno
import { SunoClient } from '@runapi.ai/suno';
const client = new SunoClient();
const result = await client.textToMusic.run({
model: 'suno-v4',
prompt: 'Write a lo-fi chill beat with soft piano, vinyl crackle, and a gentle bass line, 2 minutes long.',
});How to call this model
Install the skill
Add the model skill to your agent or install the SDK package.
Authenticate once
Use your RunAPI key for every supported model.
Send a request
Use the unified schema for the endpoint you need.
Receive output
Poll by task ID or handle the callback when the generation completes.
SDK quickstart
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v4",
"prompt": "Write a lo-fi chill beat with soft piano, vinyl crackle, and a gentle bass line, 2 minutes long."
}'import { SunoClient } from "@runapi.ai/suno";
const client = new SunoClient();
const result = await client.textToMusic.run({
model: "suno-v4",
prompt: "Write a lo-fi chill beat with soft piano, vinyl crackle, and a gentle bass line, 2 minutes long.",
});require "runapi/suno"
client = RunApi::Suno::Client.new
result = client.text_to_music.run(
model: "suno-v4",
prompt: "Write a lo-fi chill beat with soft piano, vinyl crackle, and a gentle bass line, 2 minutes long."
)Where Suno fits
Suno is an AI music generation platform that creates original songs — vocals, instruments, and lyrics — from text descriptions. Through RunAPI, all Suno versions share a single API key with per-call billing.
Why use Suno through RunAPI
One API key
Use the same credentials across models and providers.
Agent-ready
Installable skills include docs and schema for tool calls.
Predictable billing
Usage-based pricing is visible before you call.
Frequently asked questions
How do I call this model?
Use the RunAPI SDK, CLI, or REST endpoint shown on this page.
Do failed generations cost money?
Fehlgeschlagene Generierungen werden nicht berechnet
Can agents use it directly?
Yes. Install the model skill and your agent gets the docs, schema, and examples.
