Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
No output yet. Submit the form to generate content.
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 mashup musicSuno | Starter | 1per run | $0.005 | - | - |
Complete guide to using Suno
Use the Suno Mashup API on ApiPass to combine exactly two public audio files into a new AI-generated music track. Guide the blend with prompts, choose model versions up to V5_5, enable custom style and title controls, and retrieve asynchronous results through task polling or callbacks.
The Suno Mashup API blends two public audio URLs into a new generated track. Both source files are submitted with a prompt, generation mode, and model version so the system can combine melodic, rhythmic, vocal, or instrumental elements into coherent music. The workflow is asynchronous: create a task with /api/v1/jobs/createTask, save data.taskId, then query /api/v1/jobs/recordInfo until the state becomes success or fail. Successful results return resultJson as a JSON string containing the upstream task ID and generated audio track data.
Submit exactly two directly accessible public audio URLs and generate a new track that blends musical ideas from both sources. The API is designed for remix workflows, creative music experiments, and applications that need programmatic audio-to-audio music generation.
Use a prompt to describe how the source tracks should be combined, such as preserving a melodic hook, changing the energy, or blending one track's rhythm with another track's mood. In non-custom mode, the prompt is required and supports up to 500 characters.
Enable customMode to provide title, style, vocal gender, and weight controls. Custom vocal mode requires uploadUrlList, style, title, and prompt, while custom instrumental mode requires uploadUrlList, style, and title with an optional prompt.
A successful create response means the mashup task has been submitted, not that the track is finished. ApiPass returns data.taskId so your application can poll recordInfo or receive the same result structure through a callback URL.
Choose from V5_5, V5, V4_5PLUS, V4_5ALL, V4_5, and V4. Version names are normalized to uppercase, and V5 is used by default when no version is provided.
Control style adherence, creative deviation, and source-audio influence with styleWeight, weirdnessConstraint, and audioWeight. Each accepts values from 0 to 1 with up to two decimal places.
Build tools that combine two tracks into a new generated piece, letting users experiment with melody, rhythm, style, and instrumental direction through a simple prompt-driven interface.
Integrate mashup generation into creator apps where users upload or reference two public audio files, select a model version, and generate new tracks for demos, social content, and idea exploration.
Use custom instrumental mode to create title- and style-guided music blends without vocals. This is useful for background music, intros, ambient beds, and concept tracks.
Choose the mode combination that matches your generation workflow. Required fields change based on customMode and instrumental settings.
When customMode is false, uploadUrlList and prompt are required. Custom fields such as style, title, vocalGender, and weight controls are ignored. This mode is the simplest way to create a prompt-guided mashup.
When customMode is true and instrumental is false, uploadUrlList, style, title, and prompt are required. You can also set vocalGender, styleWeight, weirdnessConstraint, audioWeight, model, and duration when supported.
When customMode is true and instrumental is true, uploadUrlList, style, and title are required, while prompt is optional. This mode focuses on instrumental-only generation with custom style direction.
If required parameters are missing or invalid, ApiPass rejects the request before upstream generation and does not consume credits.
The channel parameter can be set to auto, starter, regular, or official. The default auto route allocates tasks across available providers based on pricing and stability metrics.
ApiPass provides a points-based access model for AI music workflows, suitable for individual builders and production teams that need scalable asynchronous generation.
Provide exactly two audio URLs that can be downloaded directly from the public internet. Local paths, expired links, and login-protected files are not supported.
Send a POST request to /api/v1/jobs/createTask with model set to suno/mashup and your mashup parameters inside input. You may include callBackUrl if you want ApiPass to notify your endpoint when the task completes.
Save data.taskId from the create response and call /api/v1/jobs/recordInfo?taskId=<APIPASS_TASK_ID> until state becomes success or fail. When successful, parse data.resultJson to read the generated tracks, audio URLs, cover URLs, title, and duration.
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
Submit a Suno Mashup task that combines two public audio files into a new Suno music track.
The API accepts a JSON payload with the following structure:
1{
2 "model": "suno/mashup",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "uploadUrlList": [
7 "https://cdn.example.com/audio-one.mp3",
8 "https://cdn.example.com/audio-two.mp3"
9 ],
10 "prompt": "string",
11 "customMode": false,
12 "instrumental": false,
13 "model": "V5"
14 }
15}modelRequiredstringThe public model name. For this endpoint, the value is fixed to suno/mashup.
"suno/mashup"
callBackUrlOptionalstringCallback URL for task completion notifications. If omitted, no callback will be sent.
"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
The input object contains the following parameters:
input.uploadUrlListRequiredarray(string)Two public audio URLs to mash up. The array must contain exactly 2 non-empty URL strings.
Provide exactly two public audio URLs. The URLs must be directly downloadable by ApiPass and must not require authentication.
["https://cdn.example.com/audio-one.mp3", "https://cdn.example.com/audio-two.mp3"]
input.promptRequiredstringText prompt that guides how Suno blends the two source audio files. In non-custom mode, the maximum length is 500 characters. In custom mode, V4 supports up to 3000 characters and other versions support up to 5000 characters.
Required in non-custom mode. In custom mode, it is required when instrumental is false and optional when instrumental is true.
"Blend a dreamy piano melody with a warm acoustic rhythm"
input.customModeOptionalbooleanWhether to enable detailed style, title, and weight controls. Defaults to false. Boolean aliases such as true, false, 1, 0, yes, and no are accepted and normalized to booleans.
false
input.instrumentalOptionalbooleanWhether to generate instrumental-only music. Defaults to false. Boolean aliases such as true, false, 1, 0, yes, and no are accepted and normalized to booleans.
false
input.modelOptionalstringSuno model version. Defaults to V5. Version matching is case-insensitive and is normalized to uppercase before being sent upstream.
Available options:
"V5"
input.styleRequiredstringMusic style description used in custom mode.
Required when customMode is true. V4 supports up to 200 characters; other versions support up to 1000 characters.
"Cinematic pop, nostalgic"
input.titleRequiredstringTitle for the generated music in custom mode.
Required when customMode is true. Maximum length is 80 characters.
"A New Beginning"
input.vocalGenderOptionalstringPreferred vocal tendency. Use m for male vocals or f for female vocals. Only effective in custom mode.
Available options:
"f"
input.styleWeightOptionalnumberStrength of adherence to the requested style. Valid range is 0 to 1 in 0.01 increments.
Use values from 0 to 1 with at most two decimal places. Numeric strings are normalized to numbers.
0.61
input.weirdnessConstraintOptionalnumberControls experimental or creative deviation. Valid range is 0 to 1 in 0.01 increments.
Use values from 0 to 1 with at most two decimal places. Numeric strings are normalized to numbers.
0.2
input.audioWeightOptionalnumberRelative weight of the source audio characteristics. Valid range is 0 to 1 in 0.01 increments.
Use values from 0 to 1 with at most two decimal places. Numeric strings are normalized to numbers.
0.65
input.durationOptionalnumberTarget duration in seconds. Effective only when customMode=true and model=V5_5. Valid range is 10 to 360 seconds.
Only sent when customMode is true and input.model is V5_5.
60
1curl --request POST \
2 --url "https://api.apipass.dev/api/v1/jobs/createTask" \
3 --header "Authorization: Bearer ${APIPASS_API_KEY}" \
4 --header "Content-Type: application/json" \
5 --data '{
6 "model": "suno/mashup",
7 "callBackUrl": "https://your-domain.com/api/callback",
8 "channel": "auto",
9 "input": {
10 "uploadUrlList": [
11 "https://cdn.example.com/audio-one.mp3",
12 "https://cdn.example.com/audio-two.mp3"
13 ],
14 "prompt": "Blend a dreamy piano melody with a warm acoustic rhythm",
15 "customMode": false,
16 "instrumental": false,
17 "model": "V5"
18 }
19 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_xxxxxxxxxxxxxxxx"
6 }
7}codeStatus code, 200 for success, others for failure.
messageResponse message. When the request fails, this contains the error description.
data.taskIdApiPass task ID. Use this ID to query task 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