Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
No audio yet. Submit the form to generate audio.
Explore different use cases and parameter configurations
Transparent pricing with no hidden fees. Pay as you go.
| Rule & Modality | Channel | Credits | Price (USD) | Official / Reference Price | Daily Savings |
|---|---|---|---|---|---|
Suno generate musicSuno | Starter | 1per run | $0.005 | - | - |
Complete guide to using Suno
Generate original AI music with customizable styles, vocals, and moods using the most advanced Suno V5_5 model through a simple API.
Suno V5_5 is the latest generation of AI music creation technology that can generate full songs with vocals, lyrics, and instrumental arrangements from simple text prompts. The Suno V5_5 API allows developers to integrate this powerful music generation capability into their applications, enabling users to create unique, royalty-free music for content creation, games, podcasts, and more. With support for multiple genres, vocal styles, and advanced customization options, Suno V5_5 represents the cutting edge of AI-powered music production.
Just provide a text prompt describing the music you want. The AI handles style, structure, and lyrics automatically. Perfect for quick music generation without detailed configuration.
Take full control with custom mode. Specify the exact style, title, and optionally your own lyrics. Ideal for precise creative control and professional productions requiring specific musical attributes.
Generate complete songs including AI-sung vocals with coherent lyrics that match your prompt. The Suno V5_5 model creates natural-sounding vocals in multiple languages and styles.
Create pure instrumental tracks without vocals. Perfect for background music, game soundtracks, meditation apps, and any use case requiring music without lyrics.
Support for hundreds of music genres from pop, rock, and hip-hop to classical, electronic, and world music. Combine multiple styles and use negative tags to exclude unwanted elements.
Choose between male and female vocals to match your creative vision. The AI delivers natural-sounding voices that adapt to the musical style.
Fine-tune your creations with style weight, weirdness constraint, and audio weight parameters. Balance between following prompts strictly and allowing creative exploration.
Get started with AI music generation in just a few steps
Sign up for an apipass.dev account and obtain your API key. This key authenticates all your requests to the Suno V5_5 music generation endpoints.
Use the interactive playground to experiment with different prompts, styles, and parameters. Preview generated music before integrating into your application.
Call the Create Task API with your prompt and parameters. The API returns a task ID that you can use to track generation progress.
Query the task status or receive a callback when generation completes. Download the generated audio files for use in your application.
Integrate the API into your production workflow. Generate music on-demand for your users with consistent quality and fast turnaround times.
Follow these guidelines to get the best results from Suno V5_5
Include specific details about mood, tempo, instruments, and theme. Instead of 'happy song', try 'upbeat pop song with acoustic guitar, sunny vibes, and catchy chorus about friendship'.
Exclude unwanted elements with negative tags. If you want calm music, add 'aggressive, loud, heavy' to negative tags to prevent those characteristics.
Adjust styleWeight for prompt adherence and weirdnessConstraint for creativity. Start with defaults and fine-tune based on your results.
Enable creators to generate custom background music for videos, podcasts, and social media content without licensing concerns.
Create dynamic soundtracks that adapt to gameplay. Generate unique music for different levels, moods, and game events.
Produce original jingles and background tracks for commercials, promotional videos, and brand content at scale.
Generate calming, ambient music for relaxation, sleep, and meditation applications with infinite variety.
Access Suno V5_5's powerful music generation at affordable rates. Pay only for what you use with transparent credit-based pricing.
Built on enterprise-grade infrastructure with high availability. Fast generation times and consistent quality for production workloads.
Clean REST API with comprehensive documentation, code examples, and interactive playground. Get started in minutes.
All APIs require authentication via Bearer Token.
Authorization: Bearer
Use the SDK to create tasks, store the returned taskId, and retrieve results for Suno.
Install @apipass-dev/apipass-sdk before running these SDK examples.
1npm install @apipass-dev/apipass-sdk
2# or
3pnpm add @apipass-dev/apipass-sdk
4# or
5yarn add @apipass-dev/apipass-sdkKeep your API key in server-side environment variables. The SDK sends it as a Bearer token and adds JSON headers automatically.
client.jobs.createTaskCreate a new Suno V6 music generation task
Use this example to get started quickly with the selected SDK.
1import { Apipass } from "@apipass-dev/apipass-sdk";
2
3const client = new Apipass({
4 apiKey: process.env.APIPASS_API_KEY!,
5});
6
7const task = await client.jobs.createTask({
8 "model": "suno/generate",
9 "callBackUrl": "https://your-domain.com/api/callback",
10 "input": {
11 "prompt": "A catchy pop song about summer love with upbeat tempo and cheerful melody",
12 "customMode": false,
13 "instrumental": false,
14 "vocalGender": "f"
15 }
16});
17
18console.log(task.data.taskId);The API accepts a JSON payload with the following structure:
1{
2 "model": "suno/generate",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "model_version": "V6 | V6_MINI | V6_WILD",
6 "prompt": "string",
7 "customMode": "boolean",
8 "instrumental": "boolean",
9 "style": "string",
10 "title": "string",
11 "vocalGender": "m | f",
12 "negativeTags": "string",
13 "styleWeight": "number",
14 "weirdnessConstraint": "number",
15 "audioWeight": "number"
16 },
17 "channel": "auto"
18}modelRequiredstringModel identifier for Suno V6 music generation
"suno/generate"
callBackUrlOptionalstringURL to receive webhook notifications when generation completes
"https://your-domain.com/api/callback"
channelOptionalstringYou may specify the corresponding provider within APIPASS via the channel parameter; these providers handle the actual image and video generation tasks. APIPASS currently offers three provider options:
The default value for the channel parameter is auto. When enabled, APIPASS automatically allocates tasks across available providers based on real-time pricing and stability metrics to balance minimal cost and reliable performance. Retain the default auto value unless you have custom routing requirements.
Available options:
auto
Parameters for music generation:
input.model_versionOptionalstringSuno model version to use. Defaults to V6.
Available options:
"V6"
input.promptOptionalstringText description of the music to generate. Required when customMode is false, or when customMode is true and instrumental is false.
customMode=false: prompt is required, max 500 characters. customMode=true + instrumental=false: prompt is required. customMode=true + instrumental=true: prompt is optional. For customMode=true: V4: max 3000 characters; V5_5, V5, V4_5PLUS, V4_5ALL, V4_5: max 5000 characters
"A catchy pop song about summer love with upbeat tempo"
input.customModeOptionalbooleanEnable custom mode for more control. When true, style and title are required.
When customMode=false, style and title are ignored and will not be sent to the provider.
Parameter modes:
customMode=false + instrumental=false
promptcustomMode=false + instrumental=true
promptcustomMode=true + instrumental=false
styletitlepromptcustomMode=true + instrumental=true
styletitlepromptfalse
input.instrumentalOptionalbooleanGenerate instrumental music without vocals.
false
input.styleOptionalstringMusic style/genre. Required when customMode is true.
Required when customMode=true. Ignored when customMode=false. V6 | V6_MINI | V6_WILD: max 1000 characters
"Pop, Upbeat, Summer Vibes"
input.titleOptionalstringTitle for the generated music. Required when customMode is true.
Max length: 80 characters
"Summer Love"
input.vocalGenderOptionalstringGender of the vocals in the generated song.
Only effective when customMode=true.
Available options:
"f"
input.personaIdOptionalstringPersona ID for the generated song.
Only effective when customMode=true.
"1234567890"
input.negativeTagsOptionalstringStyles or features to exclude from generation.
Only effective when customMode=true.
"aggressive, heavy metal, screaming"
input.styleWeightOptionalnumberHow strictly to follow the style. Range: 0.0-1.0
Only effective when customMode=true. Ignored when customMode=false. Number between 0.00 and 1.00. Must use increments of 0.01. Boolean values are not accepted.
0.5
input.weirdnessConstraintOptionalnumberControls creativity level. Higher values produce more experimental results. Range: 0.0-1.0
Only effective when customMode=true. Ignored when customMode=false. Number between 0.00 and 1.00. Must use increments of 0.01. Boolean values are not accepted.
0.3
input.audioWeightOptionalnumberAudio influence weight for generation. Range: 0.0-1.0
Only effective when customMode=true. Ignored when customMode=false. Number between 0.00 and 1.00. Must use increments of 0.01. Boolean values are not accepted.
0.5
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_abc123xyz"
6 }
7}codeStatus code, 200 for success
messageResponse message
data.taskIdUnique task ID for querying status and results
When generation completes, a POST request is sent to your callBackUrl
1{
2 "code": 200,
3 "data": {
4 "taskId": "task_abc123xyz",
5 "state": "success",
6 "completeTime": 1755599644000,
7 "costTime": 45000,
8 "createTime": 1755599599000,
9 "model": "suno/generate",
10 "resultJson": {
11 "data": [
12 {
13 "id": "audio_001",
14 "audio_url": "https://cdn.apipass.dev/results/task_abc123xyz_0_audio.mp3",
15 "image_url": "https://cdn.apipass.dev/results/task_abc123xyz_0_cover.jpeg",
16 "duration": 180.5,
17 "title": "Summer Love",
18 "style": "Pop"
19 },
20 {
21 "id": "audio_002",
22 "audio_url": "https://cdn.apipass.dev/results/task_abc123xyz_1_audio.mp3",
23 "image_url": "https://cdn.apipass.dev/results/task_abc123xyz_1_cover.jpeg",
24 "duration": 175.2,
25 "title": "Summer Love",
26 "style": "Pop"
27 }
28 ]
29 }
30 },
31 "msg": "Task completed successfully."
32}1{
2 "code": 501,
3 "data": {
4 "taskId": "task_abc123xyz",
5 "state": "fail",
6 "failCode": "GENERATION_FAILED",
7 "failMsg": "Music generation failed due to content policy violation"
8 },
9 "msg": "Task failed."
10}client.jobs.recordInfoQuery task status and retrieve generated music
Use this example to get started quickly with the selected SDK.
1import { Apipass } from "@apipass-dev/apipass-sdk";
2
3const client = new Apipass({
4 apiKey: process.env.APIPASS_API_KEY!,
5});
6
7const result = await client.jobs.recordInfo("task_abc123xyz");
8
9console.log(result.data.state);
10console.log(result.data.resultJson);1{
2 "code": 200,
3 "data": {
4 "taskId": "task_abc123xyz",
5 "state": "success",
6 "resultJson": {
7 "data": [
8 {
9 "id": "audio_001",
10 "audio_url": "https://cdn.apipass.dev/results/task_abc123xyz_0_audio.mp3",
11 "image_url": "https://cdn.apipass.dev/results/task_abc123xyz_0_cover.jpeg",
12 "duration": 180.5
13 }
14 ]
15 }
16 }
17}codeStatus code, 200 for success
data.taskIdThe task ID
data.stateCurrent state: queuing, generating, success, or fail
data.resultJson.dataArray of generated audio tracks with URLs and metadata
The API page shows the parameter schema, but Suno also has several business-specific mode combinations and callback rules that are easy to miss.
All APIs require authentication via Bearer Token.
Authorization: Bearer
Create a new Suno V6 music generation task
The API accepts a JSON payload with the following structure:
1{
2 "model": "suno/generate",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "model_version": "V6 | V6_MINI | V6_WILD",
6 "prompt": "string",
7 "customMode": "boolean",
8 "instrumental": "boolean",
9 "style": "string",
10 "title": "string",
11 "vocalGender": "m | f",
12 "negativeTags": "string",
13 "styleWeight": "number",
14 "weirdnessConstraint": "number",
15 "audioWeight": "number"
16 },
17 "channel": "auto"
18}modelRequiredstringModel identifier for Suno V6 music generation
"suno/generate"
callBackUrlOptionalstringURL to receive webhook notifications when generation completes
"https://your-domain.com/api/callback"
channelOptionalstringYou may specify the corresponding provider within APIPASS via the channel parameter; these providers handle the actual image and video generation tasks. APIPASS currently offers three provider options:
The default value for the channel parameter is auto. When enabled, APIPASS automatically allocates tasks across available providers based on real-time pricing and stability metrics to balance minimal cost and reliable performance. Retain the default auto value unless you have custom routing requirements.
Available options:
auto
Parameters for music generation:
input.model_versionOptionalstringSuno model version to use. Defaults to V6.
Available options:
"V6"
input.promptOptionalstringText description of the music to generate. Required when customMode is false, or when customMode is true and instrumental is false.
customMode=false: prompt is required, max 500 characters. customMode=true + instrumental=false: prompt is required. customMode=true + instrumental=true: prompt is optional. For customMode=true: V4: max 3000 characters; V5_5, V5, V4_5PLUS, V4_5ALL, V4_5: max 5000 characters
"A catchy pop song about summer love with upbeat tempo"
input.customModeOptionalbooleanEnable custom mode for more control. When true, style and title are required.
When customMode=false, style and title are ignored and will not be sent to the provider.
Parameter modes:
customMode=false + instrumental=false
promptcustomMode=false + instrumental=true
promptcustomMode=true + instrumental=false
styletitlepromptcustomMode=true + instrumental=true
styletitlepromptfalse
input.instrumentalOptionalbooleanGenerate instrumental music without vocals.
false
input.styleOptionalstringMusic style/genre. Required when customMode is true.
Required when customMode=true. Ignored when customMode=false. V6 | V6_MINI | V6_WILD: max 1000 characters
"Pop, Upbeat, Summer Vibes"
input.titleOptionalstringTitle for the generated music. Required when customMode is true.
Max length: 80 characters
"Summer Love"
input.vocalGenderOptionalstringGender of the vocals in the generated song.
Only effective when customMode=true.
Available options:
"f"
input.personaIdOptionalstringPersona ID for the generated song.
Only effective when customMode=true.
"1234567890"
input.negativeTagsOptionalstringStyles or features to exclude from generation.
Only effective when customMode=true.
"aggressive, heavy metal, screaming"
input.styleWeightOptionalnumberHow strictly to follow the style. Range: 0.0-1.0
Only effective when customMode=true. Ignored when customMode=false. Number between 0.00 and 1.00. Must use increments of 0.01. Boolean values are not accepted.
0.5
input.weirdnessConstraintOptionalnumberControls creativity level. Higher values produce more experimental results. Range: 0.0-1.0
Only effective when customMode=true. Ignored when customMode=false. Number between 0.00 and 1.00. Must use increments of 0.01. Boolean values are not accepted.
0.3
input.audioWeightOptionalnumberAudio influence weight for generation. Range: 0.0-1.0
Only effective when customMode=true. Ignored when customMode=false. Number between 0.00 and 1.00. Must use increments of 0.01. Boolean values are not accepted.
0.5
1curl -X POST "https://api.apipass.dev/api/v1/jobs/createTask" \
2 -H "Content-Type: application/json" \
3 -H "Authorization: Bearer YOUR_API_KEY" \
4 -d '{
5 "model": "suno/generate",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "prompt": "A catchy pop song about summer love with upbeat tempo and cheerful melody",
9 "customMode": false,
10 "instrumental": false,
11 "vocalGender": "f"
12 }
13 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_abc123xyz"
6 }
7}codeStatus code, 200 for success
messageResponse message
data.taskIdUnique task ID for querying status and results
MiniMax
MiniMax
MiniMax Music 1.5 AI music generation model, supports lyrics and style prompt to generate music
Starting from
0 credits
Starting from
0 credits