Overview
Suno AI is a powerful music generation platform that creates high-quality music from text descriptions. Using Suno’s API, you can create original songs, background music, instrumentals, and custom audio compositions by simply describing what you want in natural language. Related Guides: Suno Official Documentation | Music Generation Guide This endpoint allows you to submit music generation tasks using simple text prompts. The generation is processed asynchronously - you’ll receive a task ID immediately, which you can use to check the status and retrieve the generated audio once complete.Authentication
This endpoint requires authentication using a Bearer token.Your API key in the format:
Bearer YOUR_API_KEYRequest Body
Custom-mode lyrics or description. Provide detailed text description of the music you want to generate for custom mode with specific lyrics or theme.
Inspiration-mode prompt. Use AI to generate music from a high-level description. This mode lets the AI interpret and create music based on your creative description. Great for exploring new musical ideas.
Set to
true to generate instrumental music without vocals. Set to false to include vocals in the generated music.Model version to use for generation. Available options:
"chirp-v3-5"- Latest model with improved quality"chirp-v3-0"- Default stable model
Music style tags separated by commas for custom mode (e.g., “cinematic,epic,ambient”, “orchestral,dramatic,intense”). These tags help guide the style and mood of the generated music.
Custom-mode title for the generated song. If not provided, a title will be auto-generated based on the prompt or description.
Extension length in seconds. Specify how many seconds to extend from the original clip (e.g., 8 for 8 seconds extension). Used when extending existing music.
Clip ID to extend from (e.g., “clip-123456”). Use this parameter to continue or extend previously generated music clips. Get the clip ID from previous generation responses.
Follow-up task ID for tracking related generation tasks. Use this to link multiple generation requests together for better organization and tracking.
Request Example
Response
Successful response
Error Responses
Generation Modes
Suno supports two main generation modes:Inspiration Mode (AI-Driven)
Usegpt_description_prompt to let the AI interpret your creative description and generate music.
Best for: Creative exploration, when you want AI to interpret your idea
Custom Mode (Direct Control)
Useprompt, tags, and title for more direct control over the output.
Best for: Specific requirements, when you know exactly what you want
Extension/Continuation Mode
Extend existing music clips usingcontinue_clip_id and continue_at.
Best for: Making longer tracks, creating variations
Next Steps
After successfully submitting a music generation task, you’ll receive a task ID. Use this ID to:- Check Task Status - Query the Task Status endpoint to monitor progress
- Retrieve Generated Audio - Once completed, get the audio URL from the task status response
- Download Audio - Use the audio URL to download your generated music file
Example Workflow
Python
Best Practices
Writing Effective Prompts
Example Prompts
Model Selection
| Model | Best For | Characteristics |
|---|---|---|
chirp-v3-5 | Latest features, highest quality | Improved audio quality, better style adherence |
chirp-v3-0 | Stable, reliable generation | Default choice, well-tested |
Parameter Recommendations
| Use Case | Recommended Settings |
|---|---|
| Background Music | make_instrumental: true, tags: “ambient,background,subtle” |
| Game Sound Effects | make_instrumental: true, mv: “chirp-v3-5” |
| Podcast Intro | make_instrumental: true, tags: “intro,professional,upbeat” |
| Video Content | Use gpt_description_prompt for creative freedom |
| Custom Song | Set custom title, specify detailed prompt and tags |
| Music Extension | Use continue_clip_id and continue_at |
Related Endpoints
- Query Task Status - Check generation progress and retrieve audio
- Custom Music - Generate with lyrics and advanced options
- Music Continuation - Extend existing tracks
Official Resources
Suno AI Documentation
- Suno Official Website - Main Suno AI platform
- Suno API Documentation - Official API reference
- Music Generation Guide - Best practices for music generation
- Suno Model Information - Details about Chirp models and capabilities
- Suno Community - Join the Suno Discord community
GPT Proto Resources
- GPT Proto Dashboard - Manage your API keys and usage
- GPT Proto Documentation - Complete API documentation
- API Pricing - Current pricing information
- Support - Get help with integration
Additional Resources
- Suno Terms of Service - Usage terms and conditions
- Content Policy - Content generation guidelines
- API Rate Limits - Rate limiting information
- Troubleshooting Guide - Common issues and solutions

