The following fields are optional controls available for this endpoint:
lyrics (string): Lyrics for the mashup. Takes priority over prompt. If omitted, prompt is used as the lyrics. For V6, V6_WILD, and V6_MINI: maximum 5000 characters.
vocalGender (string): Preferred vocal gender. Allowed values: m (male), f (female)
styleWeight (number): Style adherence weight in range 0–1 (recommended two decimals)
weirdnessConstraint (number): Creativity/novelty constraint in range 0–1 (recommended two decimals)
audioWeight (number): Relative weight of audio consistency in range 0–1 (recommended two decimals)
duration (number): Duration in seconds, range 10–360. Only effective with V5_5 (Deprecated), V6, V6_WILD, or V6_MINI.
variety (integer): Diversity of generated results. Integer from 0–4, default 1. 0 off, 1 normal (default), 2 high, 3 extra, 4 max.
personaId (string): Persona ID or Suno Voice voiceId to apply to the generated music. If you use a Voice-generated ID, set personaModel to voice_persona.
personaModel (string): Persona type, default style_persona. Use style_persona for Generate Persona IDs, or voice_persona for Suno Voice IDs.
V6: Current standard model and recommended default.
V6_WILD: Current model for more experimental and creative results.
V6_MINI: Current lightweight model.
Deprecated: V5_5, V5, V4_5PLUS, V4_5ALL, V4_5, and V4. These values remain listed only for backward compatibility; use a V6-series model for new integrations.
Lyrics for the mashup. Optional. The prompt is used strictly as lyrics and sung in the generated track. When lyrics is also provided, lyrics takes priority and prompt is not used as lyrics. Character limits by model:
V4 (Deprecated): Maximum 3000 characters
V4_5, V4_5PLUS, V5, V5_5 & V4_5ALL (Deprecated): Maximum 5000 characters
Vocal gender preference for the singing voice. Optional. Use 'm' for male and 'f' for female. Based on practice, this parameter can only increase the probability but cannot guarantee adherence to male/female voice instructions.
Persona model type to apply when using personaId. Optional.
style_persona (default): Use this for Persona IDs generated by the Generate Persona endpoint.
voice_persona: Required when personaId is a voiceId generated by Suno Voice. This option is only available with V5 (Deprecated), V5_5 (Deprecated), V6, V6_WILD, and V6_MINI models.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"API Box","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://api.box/logo.png","dark":"https://api.box/logo.png"},"favicon":"https://mintcdn.com/apibox-ba51f6c3/EVzMQXQCXm7-Rdw8/favicon.ico?fit=max\u0026auto=format\u0026n=EVzMQXQCXm7-Rdw8\u0026q=85\u0026s=c059e605bf3478ad64a7acc7a137812c","navbar":{"links":[{"href":"mailto:support@api.box","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://api.box/dashboard"}},"footer":{},"contextual":{"options":["copy","view","chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Home","icon":"house","href":"https://api.box/"}]},"languages":[{"language":"en","href":""},{"language":"cn","href":"cn"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"apibox-ba51f6c3","hasAudioNarration":false,"actualSubdomain":"apibox-ba51f6c3","customDomains":["docs.api.box"],"gitSource":{"type":"gitlab","owner":"development","repo":"docs.api.box","deployBranch":"main","contentDirectory":"","isPrivate":true,"projectId":310,"hostUrl":"https://gitlab.tattooidea.ai","mountPath":"","label":""},"entitlements":{},"buildId":"6ad43a78b1c0141de368cc60","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"cn","tag":"Generate Music","count":24},{"language":"en","tag":"Generate Music","count":24},{"language":"cn","tag":"Suno Voice","count":9},{"language":"en","tag":"Suno Voice","count":9},{"language":"cn","tag":"Vocal Removal","count":6},{"language":"en","tag":"Vocal Removal","count":6},{"language":"cn","tag":"文件上传API","count":4},{"language":"en","tag":"File Upload API","count":4},{"language":"cn","tag":"WAV Conversion","count":3},{"language":"cn","tag":"Music Video Generation","count":3},{"language":"cn","tag":"Lyrics Generation","count":3},{"language":"en","tag":"WAV Conversion","count":3},{"language":"en","tag":"Music Video Generation","count":3},{"language":"en","tag":"Lyrics Generation","count":3},{"language":"cn","tag":"Generate Sounds","count":1},{"language":"cn","tag":"Account Management","count":1},{"language":"en","tag":"Generate Sounds","count":1},{"language":"en","tag":"Account Management","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"suno-api/generate-mashup","slug":"/suno-api/generate-mashup","pageMetadata":{"title":"Generate Mashup","description":"Mix two audio files to generate a new mashup work using AI models.","openapi":"suno-api/suno-api.json POST /api/v1/generate/mashup","href":"/suno-api/generate-mashup"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Mix two audio files to generate a new mashup work using AI models.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Note}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`3`,id:`model-versions`,children:`Model Versions`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Current models`}),`: `,_jsx(_components.code,{children:`V6`}),` (default), `,_jsx(_components.code,{children:`V6_WILD`}),`, `,_jsx(_components.code,{children:`V6_MINI`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Deprecated models`}),`: `,_jsx(_components.code,{children:`V5_5`}),`, `,_jsx(_components.code,{children:`V5`}),`, `,_jsx(_components.code,{children:`V4_5PLUS`}),`, `,_jsx(_components.code,{children:`V4_5ALL`}),`, `,_jsx(_components.code,{children:`V4_5`}),`, `,_jsx(_components.code,{children:`V4`})]}),`\n`,_jsx(_components.li,{children:`Deprecated values remain available only for backward compatibility. New integrations should use a V6-series model.`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`usage-guide`,children:`Usage Guide`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`This endpoint always uses custom parameters. Simple mode is not available.`}),`\n`,_jsx(_components.li,{children:`This endpoint creates mashup music from 2 uploaded audio files`}),`\n`,_jsx(_components.li,{children:`Combines elements from multiple tracks into a cohesive new composition`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`parameter-details`,children:`Parameter Details`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`uploadUrlList`}),` is required and must contain exactly 2 audio file URLs; only the first 2 are used`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`model`}),` (string, required): `,_jsx(_components.code,{children:`V6`}),`, `,_jsx(_components.code,{children:`V6_WILD`}),`, `,_jsx(_components.code,{children:`V6_MINI`}),`. Deprecated: `,_jsx(_components.code,{children:`V4`}),`, `,_jsx(_components.code,{children:`V4_5`}),`, `,_jsx(_components.code,{children:`V4_5PLUS`}),`, `,_jsx(_components.code,{children:`V4_5ALL`}),`, `,_jsx(_components.code,{children:`V5`}),`, `,_jsx(_components.code,{children:`V5_5`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`style`}),` and `,_jsx(_components.code,{children:`title`}),` are required`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`prompt`}),` is optional and is treated as lyrics. When `,_jsx(_components.code,{children:`lyrics`}),` is also provided, `,_jsx(_components.code,{children:`lyrics`}),` takes priority and `,_jsx(_components.code,{children:`prompt`}),` is not used as lyrics`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`lyrics`}),` is optional. It takes priority over `,_jsx(_components.code,{children:`prompt`}),` as the lyrics. If `,_jsx(_components.code,{children:`lyrics`}),` is omitted, `,_jsx(_components.code,{children:`prompt`}),` is used as the lyrics`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Character limits (based on model):`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`V4, V4_5, V4_5PLUS, V4_5ALL, V5 \u0026 V5_5 (Deprecated)`}),`: `,_jsx(_components.code,{children:`prompt`}),` 3000–5000 characters and `,_jsx(_components.code,{children:`style`}),` 200–1000 characters according to the legacy model.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`V6, V6_WILD \u0026 V6_MINI`}),`: `,_jsx(_components.code,{children:`prompt`}),` and `,_jsx(_components.code,{children:`lyrics`}),` max 5000 characters, `,_jsx(_components.code,{children:`style`}),` max 1000 characters`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`title`}),` length limit: 80 characters (all models)`]}),`\n`]}),`\n`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`optional-parameters`,children:`Optional parameters`}),`\n`,_jsxs(Note,{children:[_jsx(_components.p,{children:`The following fields are optional controls available for this endpoint:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`lyrics`}),` (string): Lyrics for the mashup. Takes priority over `,_jsx(_components.code,{children:`prompt`}),`. If omitted, `,_jsx(_components.code,{children:`prompt`}),` is used as the lyrics. For V6, V6_WILD, and V6_MINI: maximum 5000 characters.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`vocalGender`}),` (string): Preferred vocal gender. Allowed values: `,_jsx(_components.code,{children:`m`}),` (male), `,_jsx(_components.code,{children:`f`}),` (female)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`styleWeight`}),` (number): Style adherence weight in range 0–1 (recommended two decimals)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`weirdnessConstraint`}),` (number): Creativity/novelty constraint in range 0–1 (recommended two decimals)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`audioWeight`}),` (number): Relative weight of audio consistency in range 0–1 (recommended two decimals)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`duration`}),` (number): Duration in seconds, range 10–360. Only effective with `,_jsx(_components.code,{children:`V5_5`}),` (Deprecated), `,_jsx(_components.code,{children:`V6`}),`, `,_jsx(_components.code,{children:`V6_WILD`}),`, or `,_jsx(_components.code,{children:`V6_MINI`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`variety`}),` (integer): Diversity of generated results. Integer from 0–4, default 1. `,_jsx(_components.code,{children:`0`}),` off, `,_jsx(_components.code,{children:`1`}),` normal (default), `,_jsx(_components.code,{children:`2`}),` high, `,_jsx(_components.code,{children:`3`}),` extra, `,_jsx(_components.code,{children:`4`}),` max.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`personaId`}),` (string): Persona ID or Suno Voice `,_jsx(_components.code,{children:`voiceId`}),` to apply to the generated music. If you use a Voice-generated ID, set `,_jsx(_components.code,{children:`personaModel`}),` to `,_jsx(_components.code,{children:`voice_persona`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`personaModel`}),` (string): Persona type, default `,_jsx(_components.code,{children:`style_persona`}),`. Use `,_jsx(_components.code,{children:`style_persona`}),` for Generate Persona IDs, or `,_jsx(_components.code,{children:`voice_persona`}),` for Suno Voice IDs.`]}),`\n`]})]}),`\n`,`\n`,_jsx(Heading,{level:`3`,id:`developer-notes`,children:`Developer Notes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`This endpoint always uses custom parameters; `,_jsx(_components.code,{children:`style`}),` and `,_jsx(_components.code,{children:`title`}),` must be provided along with the two source audio URLs`]}),`\n`,_jsx(_components.li,{children:`Generated files are retained for 14 days`}),`\n`,_jsxs(_components.li,{children:[`Callback process has three stages: `,_jsx(_components.code,{children:`text`}),` (text generation), `,_jsx(_components.code,{children:`first`}),` (first track complete), `,_jsx(_components.code,{children:`complete`}),` (all tracks complete)`]}),`\n`,_jsxs(_components.li,{children:[`The two audio files in `,_jsx(_components.code,{children:`uploadUrlList`}),` must be valid and accessible URLs`]}),`\n`,_jsx(_components.li,{children:`Audio files should be in supported formats (MP3, WAV, etc.)`}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Generate Mashup","description":"Mix two audio files to generate a new mashup work using AI models.","openapi":"suno-api/suno-api.json POST /api/v1/generate/mashup","href":"/suno-api/generate-mashup"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,RequestExample}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`3`,id:`model-versions`,children:`Model Versions`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Current models`}),`: `,_jsx(_components.code,{children:`V6`}),` (default), `,_jsx(_components.code,{children:`V6_WILD`}),`, `,_jsx(_components.code,{children:`V6_MINI`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Deprecated models`}),`: `,_jsx(_components.code,{children:`V5_5`}),`, `,_jsx(_components.code,{children:`V5`}),`, `,_jsx(_components.code,{children:`V4_5PLUS`}),`, `,_jsx(_components.code,{children:`V4_5ALL`}),`, `,_jsx(_components.code,{children:`V4_5`}),`, `,_jsx(_components.code,{children:`V4`})]}),`\n`,_jsx(_components.li,{children:`Deprecated values remain available only for backward compatibility. New integrations should use a V6-series model.`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`usage-guide`,children:`Usage Guide`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`This endpoint always uses custom parameters. Simple mode is not available.`}),`\n`,_jsx(_components.li,{children:`This endpoint creates mashup music from 2 uploaded audio files`}),`\n`,_jsx(_components.li,{children:`Combines elements from multiple tracks into a cohesive new composition`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`parameter-details`,children:`Parameter Details`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`uploadUrlList`}),` is required and must contain exactly 2 audio file URLs; only the first 2 are used`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`model`}),` (string, required): `,_jsx(_components.code,{children:`V6`}),`, `,_jsx(_components.code,{children:`V6_WILD`}),`, `,_jsx(_components.code,{children:`V6_MINI`}),`. Deprecated: `,_jsx(_components.code,{children:`V4`}),`, `,_jsx(_components.code,{children:`V4_5`}),`, `,_jsx(_components.code,{children:`V4_5PLUS`}),`, `,_jsx(_components.code,{children:`V4_5ALL`}),`, `,_jsx(_components.code,{children:`V5`}),`, `,_jsx(_components.code,{children:`V5_5`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`style`}),` and `,_jsx(_components.code,{children:`title`}),` are required`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`prompt`}),` is optional and is treated as lyrics. When `,_jsx(_components.code,{children:`lyrics`}),` is also provided, `,_jsx(_components.code,{children:`lyrics`}),` takes priority and `,_jsx(_components.code,{children:`prompt`}),` is not used as lyrics`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`lyrics`}),` is optional. It takes priority over `,_jsx(_components.code,{children:`prompt`}),` as the lyrics. If `,_jsx(_components.code,{children:`lyrics`}),` is omitted, `,_jsx(_components.code,{children:`prompt`}),` is used as the lyrics`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Character limits (based on model):`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`V4, V4_5, V4_5PLUS, V4_5ALL, V5 \u0026 V5_5 (Deprecated)`}),`: `,_jsx(_components.code,{children:`prompt`}),` 3000–5000 characters and `,_jsx(_components.code,{children:`style`}),` 200–1000 characters according to the legacy model.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`V6, V6_WILD \u0026 V6_MINI`}),`: `,_jsx(_components.code,{children:`prompt`}),` and `,_jsx(_components.code,{children:`lyrics`}),` max 5000 characters, `,_jsx(_components.code,{children:`style`}),` max 1000 characters`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`title`}),` length limit: 80 characters (all models)`]}),`\n`]}),`\n`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`optional-parameters`,children:`Optional parameters`}),`\n`,_jsxs(Note,{children:[_jsx(_components.p,{children:`The following fields are optional controls available for this endpoint:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`lyrics`}),` (string): Lyrics for the mashup. Takes priority over `,_jsx(_components.code,{children:`prompt`}),`. If omitted, `,_jsx(_components.code,{children:`prompt`}),` is used as the lyrics. For V6, V6_WILD, and V6_MINI: maximum 5000 characters.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`vocalGender`}),` (string): Preferred vocal gender. Allowed values: `,_jsx(_components.code,{children:`m`}),` (male), `,_jsx(_components.code,{children:`f`}),` (female)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`styleWeight`}),` (number): Style adherence weight in range 0–1 (recommended two decimals)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`weirdnessConstraint`}),` (number): Creativity/novelty constraint in range 0–1 (recommended two decimals)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`audioWeight`}),` (number): Relative weight of audio consistency in range 0–1 (recommended two decimals)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`duration`}),` (number): Duration in seconds, range 10–360. Only effective with `,_jsx(_components.code,{children:`V5_5`}),` (Deprecated), `,_jsx(_components.code,{children:`V6`}),`, `,_jsx(_components.code,{children:`V6_WILD`}),`, or `,_jsx(_components.code,{children:`V6_MINI`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`variety`}),` (integer): Diversity of generated results. Integer from 0–4, default 1. `,_jsx(_components.code,{children:`0`}),` off, `,_jsx(_components.code,{children:`1`}),` normal (default), `,_jsx(_components.code,{children:`2`}),` high, `,_jsx(_components.code,{children:`3`}),` extra, `,_jsx(_components.code,{children:`4`}),` max.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`personaId`}),` (string): Persona ID or Suno Voice `,_jsx(_components.code,{children:`voiceId`}),` to apply to the generated music. If you use a Voice-generated ID, set `,_jsx(_components.code,{children:`personaModel`}),` to `,_jsx(_components.code,{children:`voice_persona`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`personaModel`}),` (string): Persona type, default `,_jsx(_components.code,{children:`style_persona`}),`. Use `,_jsx(_components.code,{children:`style_persona`}),` for Generate Persona IDs, or `,_jsx(_components.code,{children:`voice_persona`}),` for Suno Voice IDs.`]}),`\n`]})]}),`\n`,_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:`JSON body`,numberOfLines:`17`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`17`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"uploadUrlList\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://example.com/audio1.mp3\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://example.com/audio2.mp3\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"lyrics\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"[Chorus] Brighter lights, we keep going on\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"prompt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"[Verse] City hums under neon rain\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"style\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Electronic Dance Music\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"title\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Mashup Work\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"V6\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"callBackUrl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com/callback\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"vocalGender\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"m\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"styleWeight\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.65`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"weirdnessConstraint\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.72`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"audioWeight\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.65`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"variety\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})}),`\n`,_jsx(Heading,{level:`3`,id:`developer-notes`,children:`Developer Notes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`This endpoint always uses custom parameters; `,_jsx(_components.code,{children:`style`}),` and `,_jsx(_components.code,{children:`title`}),` must be provided along with the two source audio URLs`]}),`\n`,_jsx(_components.li,{children:`Generated files are retained for 14 days`}),`\n`,_jsxs(_components.li,{children:[`Callback process has three stages: `,_jsx(_components.code,{children:`text`}),` (text generation), `,_jsx(_components.code,{children:`first`}),` (first track complete), `,_jsx(_components.code,{children:`complete`}),` (all tracks complete)`]}),`\n`,_jsxs(_components.li,{children:[`The two audio files in `,_jsx(_components.code,{children:`uploadUrlList`}),` must be valid and accessible URLs`]}),`\n`,_jsx(_components.li,{children:`Audio files should be in supported formats (MP3, WAV, etc.)`}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Generate Mashup","description":"Mix two audio files to generate a new mashup work using AI models.","openapi":"suno-api/suno-api.json POST /api/v1/generate/mashup","href":"/suno-api/generate-mashup"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Model Versions","slug":"model-versions","depth":3,"children":[]},{"title":"Usage Guide","slug":"usage-guide","depth":3,"children":[]},{"title":"Parameter Details","slug":"parameter-details","depth":3,"children":[]},{"title":"Optional parameters","slug":"optional-parameters","depth":3,"children":[]},{"title":"Developer Notes","slug":"developer-notes","depth":3,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"JSON body","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"17\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"uploadUrlList\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"https://example.com/audio1.mp3\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"https://example.com/audio2.mp3\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"lyrics\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"[Chorus] Brighter lights, we keep going on\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"prompt\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"[Verse] City hums under neon rain\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"style\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Electronic Dance Music\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"title\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Mashup Work\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"model\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"V6\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"callBackUrl\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://example.com/callback\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"vocalGender\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"m\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"styleWeight\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">0.65\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"weirdnessConstraint\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">0.72\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"audioWeight\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">0.65\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"variety\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"generate-mashup","summary":"Generate Mashup Music","description":"Mix two audio files to generate a new mashup work using AI models.","requestBody":"cb823e8e-a9bc-4de0-8d85-3de6a0cbee49","responses":{"200":"5c2aba4a-b079-4b16-a07f-e16405ec3ebf","500":"d8b082a5-6cb5-4daa-8f38-13f54984a933"},"callbacks":{"audioGenerated":"bf573d3a-7d1f-4f5e-9311-36e67a596691"},"method":"post","type":"path","servers":["b094bf9a-844f-44ec-9a78-4c247072091f"],"security":["272c5596-804e-4c7e-9a19-2cbe3c9f4310"],"path":"/api/v1/generate/mashup","baseUrlOptions":["https://apibox.erweima.ai"],"title":"Generate Mashup Music","codeSamples":[],"requiredOnlyExamples":false,"requestExamples":[{"dropdown":false,"language":"json","code":{"type":"pre","key":null,"ref":null,"props":{"className":"shiki shiki-themes github-light-default dark-plus","style":{"backgroundColor":"#ffffff","--shiki-dark-bg":"#0B0C0E","color":"#1f2328","--shiki-dark":"#D4D4D4"},"language":"json","children":{"type":"code","key":null,"ref":null,"props":{"language":"json","numberOfLines":"17","children":[{"type":"span","key":"0","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"{"}}}},"\n",{"type":"span","key":"2","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"uploadUrlList\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": ["}}]}},"\n",{"type":"span","key":"4","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" \"https://example.com/audio1.mp3\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"6","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" \"https://example.com/audio2.mp3\""}}}},"\n",{"type":"span","key":"8","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" ],"}}}},"\n",{"type":"span","key":"10","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"lyrics\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"[Chorus] Brighter lights, we keep going on\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"12","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"prompt\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"[Verse] City hums under neon rain\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"14","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"style\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"Electronic Dance Music\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"16","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"title\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"Mashup Work\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"18","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"model\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"V6\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"20","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"callBackUrl\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"https://example.com/callback\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"22","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"vocalGender\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"m\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"24","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"styleWeight\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#B5CEA8"},"children":"0.65"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"26","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"weirdnessConstraint\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#B5CEA8"},"children":"0.72"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"28","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"audioWeight\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#B5CEA8"},"children":"0.65"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"30","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"variety\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#B5CEA8"},"children":"1"}}]}},"\n",{"type":"span","key":"32","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"}"}}}},"\n"]}}}},"filename":"JSON body"}],"requestExampleType":"mdx","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["uploadUrlList","style","title","callBackUrl","model"],"properties":{"uploadUrlList":{"type":"array","description":"Array of audio file URLs to mashup. Required. Provide exactly 2 URLs; only the first 2 are used. Each URL must be publicly accessible.","items":{"type":"string","format":"uri","uniqueKey":"uploadUrlList.items.[INDEX]","typeLabel":"string\u003curi>"},"minItems":2,"maxItems":2,"example":["https://example.com/audio1.mp3","https://example.com/audio2.mp3"],"isRequired":true,"uniqueKey":"uploadUrlList","typeLabel":"string\u003curi>[]"},"style":{"type":"string","description":"The music style or genre. Required. Examples: \"Jazz\", \"Classical\", \"Electronic\". \n- For **V4 (Deprecated)**: Maximum 200 characters. \n- For **V4_5, V4_5PLUS, V5, V5_5 \u0026 V4_5ALL (Deprecated)**: Maximum 1000 characters. \n- For **V6, V6_WILD \u0026 V6_MINI**: Maximum 1000 characters.","example":"Jazz","isRequired":true,"uniqueKey":"style","typeLabel":"string"},"title":{"type":"string","description":"Title for the generated music track. Required. \n- Max length: 80 characters. \n- Will be displayed in player interfaces and filenames.","example":"Relaxing Piano","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"model":{"type":"string","description":"AI model version. Default: `V6`.\n- **`V6`**: Current standard model and recommended default.\n- **`V6_WILD`**: Current model for more experimental and creative results.\n- **`V6_MINI`**: Current lightweight model.\n- **Deprecated**: `V5_5`, `V5`, `V4_5PLUS`, `V4_5ALL`, `V4_5`, and `V4`. These values remain listed only for backward compatibility; use a V6-series model for new integrations.","enum":["V6","V6_WILD","V6_MINI","V5_5","V5","V4_5PLUS","V4_5ALL","V4_5","V4"],"example":"V6","default":"V6","isRequired":true,"uniqueKey":"model","typeLabel":"enum\u003cstring>"},"callBackUrl":{"type":"string","format":"uri","description":"The URL to receive music generation task completion updates. Required for all music generation requests.\n\n- System will POST task status and results to this URL when generation completes\n- Callback process has three stages: `text` (text generation), `first` (first track complete), `complete` (all tracks complete)\n- Note: Some cases may skip `text` and `first` stages and return `complete` directly\n- Your callback endpoint should accept POST requests with JSON payload containing task results and audio URLs\n- For detailed callback format and implementation guide, see [Music Generation Callbacks](https://docs.kie.ai/suno-api/generate-music-callbacks)\n- Alternatively, use the Get Music Details endpoint to poll task status","example":"https://example.com/callback","isRequired":true,"uniqueKey":"callBackUrl","typeLabel":"string\u003curi>"},"prompt":{"type":"string","description":"Lyrics for the mashup. Optional. The prompt is used strictly as lyrics and sung in the generated track. When `lyrics` is also provided, `lyrics` takes priority and `prompt` is not used as lyrics. Character limits by model: \n- **V4 (Deprecated)**: Maximum 3000 characters \n- **V4_5, V4_5PLUS, V5, V5_5 \u0026 V4_5ALL (Deprecated)**: Maximum 5000 characters \n- **V6, V6_WILD \u0026 V6_MINI**: Maximum 5000 characters","example":"[Verse] City hums under neon rain","uniqueKey":"prompt","typeLabel":"string"},"lyrics":{"type":"string","description":"Lyrics for the mashup. Optional. Takes priority over `prompt` as the lyrics. If omitted, `prompt` is used as the lyrics. \n- **V6, V6_WILD \u0026 V6_MINI**: Maximum 5000 characters","example":"[Chorus] Brighter lights, we keep going on","uniqueKey":"lyrics","typeLabel":"string"},"vocalGender":{"type":"string","description":"Vocal gender preference for the singing voice. Optional. Use 'm' for male and 'f' for female. Based on practice, this parameter can only increase the probability but cannot guarantee adherence to male/female voice instructions.","enum":["m","f"],"example":"m","uniqueKey":"vocalGender","typeLabel":"enum\u003cstring>"},"styleWeight":{"type":"number","description":"Strength of adherence to the specified style. Optional. Range 0–1, up to 2 decimal places.","minimum":0,"maximum":1,"multipleOf":0.01,"example":0.61,"uniqueKey":"styleWeight","typeLabel":"number"},"weirdnessConstraint":{"type":"number","description":"Controls experimental/creative deviation. Optional. Range 0–1, up to 2 decimal places.","minimum":0,"maximum":1,"multipleOf":0.01,"example":0.72,"uniqueKey":"weirdnessConstraint","typeLabel":"number"},"audioWeight":{"type":"number","description":"Balance weight for audio features vs. other factors. Optional. Range 0–1, up to 2 decimal places.","minimum":0,"maximum":1,"multipleOf":0.01,"example":0.65,"uniqueKey":"audioWeight","typeLabel":"number"},"duration":{"type":"number","description":"Duration in seconds. Optional. Range 10–360. Only effective when `model` is `V5_5` (Deprecated), `V6`, `V6_WILD`, or `V6_MINI`.","minimum":10,"maximum":360,"example":20,"uniqueKey":"duration","typeLabel":"number"},"variety":{"type":"integer","description":"Diversity of generated results. Optional. Integer from 0 to 4. Default: 1.\n\n- **`0`**: off — variety off, strictly the same style\n- **`1`**: normal — default, balances stability and diversity\n- **`2`**: high — results with clearly different styles\n- **`3`**: extra — higher variation, bolder exploration\n- **`4`**: max — maximum variation","minimum":0,"maximum":4,"multipleOf":1,"default":1,"example":1,"uniqueKey":"variety","typeLabel":"integer"},"personaId":{"type":"string","description":"Persona ID to apply to the generated music. Optional. You can use either:\n\n- A Persona ID generated by the [Generate Persona](https://docs.api.box/suno-api/generate-persona) endpoint. Use `personaModel: style_persona` or omit `personaModel` to use the default.\n- A `voiceId` generated by the [Suno Voice](https://docs.api.box/suno-api/suno-voice-generate) workflow. When using a voice-generated ID, you must set `personaModel: voice_persona`.","example":"persona_123","uniqueKey":"personaId","typeLabel":"string"},"personaModel":{"type":"string","description":"Persona model type to apply when using `personaId`. Optional.\n- `style_persona` (default): Use this for Persona IDs generated by the Generate Persona endpoint.\n- `voice_persona`: Required when `personaId` is a `voiceId` generated by Suno Voice. This option is only available with V5 (Deprecated), V5_5 (Deprecated), V6, V6_WILD, and V6_MINI models.","enum":["style_persona","voice_persona"],"default":"style_persona","example":"style_persona","uniqueKey":"personaModel","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"uploadUrlList":["https://example.com/audio1.mp3","https://example.com/audio2.mp3"],"style":"Jazz","title":"Relaxing Piano","model":"V6","callBackUrl":"https://example.com/callback","prompt":"[Verse] City hums under neon rain","lyrics":"[Chorus] Brighter lights, we keep going on","vocalGender":"m","styleWeight":0.61,"weirdnessConstraint":0.72,"audioWeight":0.65,"duration":20,"variety":1,"personaId":"persona_123","personaModel":"style_persona"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"5c2aba4a-b079-4b16-a07f-e16405ec3ebf":{"description":"Request successful","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","enum":[200,401,402,404,409,422,429,451,455,500],"description":"Response Status Codes\n\n- **200**: Success - Request has been processed successfully \n- **401**: Unauthorized - Authentication credentials are missing or invalid \n- **402**: Insufficient Credits - Account does not have enough credits to perform the operation \n- **404**: Not Found - The requested resource or endpoint does not exist \n- **409**: Conflict - WAV record already exists \n- **422**: Validation Error - The request parameters failed validation checks \n- **429**: Rate Limited - Request limit has been exceeded for this resource \n- **451**: Unauthorized - Failed to fetch the image. Kindly verify any access limits set by you or your service provider \n- **455**: Service Unavailable - System is currently undergoing maintenance \n- **500**: Server Error - An unexpected error occurred while processing the request","uniqueKey":"code","typeLabel":"enum\u003cinteger>"},"msg":{"type":"string","description":"Error message when code != 200","example":"success","uniqueKey":"msg","typeLabel":"string"},"data":{"type":"object","properties":{"taskId":{"type":"string","description":"Task ID for tracking task status. Use this ID with the \"Get Music Details\" endpoint to query task details and results.","example":"5c79****be8e","uniqueKey":"data.taskId","typeLabel":"string"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":200,"msg":"success","data":{"taskId":"5c79****be8e"}}}},"exampleType":"generated"}},"exampleType":"generated"},"d8b082a5-6cb5-4daa-8f38-13f54984a933":{"description":"Server error","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"callbacks":[{"callbackName":"audioGenerated","expression":"{request.body#/callBackUrl}","method":"post","resolved":{"operation":{"description":"System will call this callback when audio generation is complete.\n\n### Callback Example\n```json\n{\n \"code\": 200,\n \"msg\": \"All generated successfully.\",\n \"data\": {\n \"callbackType\": \"complete\",\n \"task_id\": \"2fac****9f72\",\n \"data\": [\n {\n \"id\": \"e231****-****-****-****-****8cadc7dc\",\n \"audio_url\": \"https://example.cn/****.mp3\",\n \"stream_audio_url\": \"https://example.cn/****\",\n \"image_url\": \"https://example.cn/****.jpeg\",\n \"prompt\": \"[Verse] Night city lights shining bright\",\n \"model_name\": \"chirp-v3-5\",\n \"title\": \"Iron Man\",\n \"tags\": \"electrifying, rock\",\n \"createTime\": \"2025-01-01 00:00:00\",\n \"duration\": 198.44\n },\n {\n \"id\": \"bd15****1873\",\n \"audio_url\": \"https://example.cn/****.mp3\",\n \"stream_audio_url\": \"https://example.cn/****\",\n \"image_url\": \"https://example.cn/****.jpeg\",\n \"prompt\": \"[Verse] Night city lights shining bright\",\n \"model_name\": \"chirp-v3-5\",\n \"title\": \"Iron Man\",\n \"tags\": \"electrifying, rock\",\n \"createTime\": \"2025-01-01 00:00:00\",\n \"duration\": 228.28\n }\n ]\n }\n}\n```","requestBody":"6b25d3e0-125b-49d2-b034-cd0b43079a12","responses":{"200":"350f82b3-7eef-44b7-8160-4ac503ff56ff"},"method":"post","type":"path"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"Status code","example":200,"uniqueKey":"code","typeLabel":"integer"},"msg":{"type":"string","description":"Response message","example":"All generated successfully","uniqueKey":"msg","typeLabel":"string"},"data":{"type":"object","properties":{"callbackType":{"type":"string","description":"Callback type: text (text generation complete), first (first track complete), complete (all tracks complete)","enum":["text","first","complete"],"uniqueKey":"data.callbackType","typeLabel":"enum\u003cstring>"},"task_id":{"type":"string","description":"Task ID","uniqueKey":"data.task_id","typeLabel":"string"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Audio unique identifier (audioId)","uniqueKey":"data.data.items.[INDEX].id","typeLabel":"string"},"audio_url":{"type":"string","description":"Audio file URL","uniqueKey":"data.data.items.[INDEX].audio_url","typeLabel":"string"},"stream_audio_url":{"type":"string","description":"Streaming audio URL","uniqueKey":"data.data.items.[INDEX].stream_audio_url","typeLabel":"string"},"image_url":{"type":"string","description":"Cover image URL","uniqueKey":"data.data.items.[INDEX].image_url","typeLabel":"string"},"prompt":{"type":"string","description":"Generation prompt/lyrics","uniqueKey":"data.data.items.[INDEX].prompt","typeLabel":"string"},"model_name":{"type":"string","description":"Model name used","uniqueKey":"data.data.items.[INDEX].model_name","typeLabel":"string"},"title":{"type":"string","description":"Music title","uniqueKey":"data.data.items.[INDEX].title","typeLabel":"string"},"tags":{"type":"string","description":"Music tags","uniqueKey":"data.data.items.[INDEX].tags","typeLabel":"string"},"createTime":{"type":"string","description":"Creation time","format":"date-time","uniqueKey":"data.data.items.[INDEX].createTime","typeLabel":"string\u003cdate-time>"},"duration":{"type":"number","description":"Audio duration (seconds)","uniqueKey":"data.data.items.[INDEX].duration","typeLabel":"number"}},"uniqueKey":"data.data.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.data","typeLabel":"object[]"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":200,"msg":"All generated successfully","data":{"task_id":"\u003cstring>","data":[{"id":"\u003cstring>","audio_url":"\u003cstring>","stream_audio_url":"\u003cstring>","image_url":"\u003cstring>","prompt":"\u003cstring>","model_name":"\u003cstring>","title":"\u003cstring>","tags":"\u003cstring>","createTime":"2023-11-07T05:31:56Z","duration":123}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"350f82b3-7eef-44b7-8160-4ac503ff56ff":{"description":"Callback received successfully","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","enum":[200,400,408,413,500,501,531],"description":"Response status code\n\n- **200**: Success - Request has been processed successfully\n- **400**: Validation Error - Lyrics contained copyrighted material.\n- **408**: Rate Limited - Timeout.\n- **413**: Conflict - Uploaded audio matches existing work of art.\n- **500**: Server Error - An unexpected error occurred while processing the request\n- **501**: Audio generation failed.\n- **531**: Server Error - Sorry, the generation failed due to an issue. Your credits have been refunded. Please try again.","uniqueKey":"code","typeLabel":"enum\u003cinteger>"},"msg":{"type":"string","description":"Error message when code != 200","example":"success","uniqueKey":"msg","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":200,"msg":"success"},"examples":{"Example":{"title":"Example","value":{"code":200,"msg":"success"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{}}}}],"security":{"272c5596-804e-4c7e-9a19-2cbe3c9f4310":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"# 🔑 API Authentication\n\nAll endpoints require authentication using Bearer Token.\n\n## Get API Key\n\n1. Visit the [API Key Management Page](https://api.box/api-key) to obtain your API Key\n\n## Usage\n\nAdd to request headers:\n\n```\nAuthorization: Bearer YOUR_API_KEY\n```\n\n> **⚠️ Note:**\n> - Keep your API Key secure and do not share it with others\n> - If you suspect your API Key has been compromised, reset it immediately from the management page","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"b094bf9a-844f-44ec-9a78-4c247072091f":{"url":"https://apibox.erweima.ai","description":"API Server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"# 🔑 API Authentication\n\nAll endpoints require authentication using Bearer Token.\n\n## Get API Key\n\n1. Visit the [API Key Management Page](https://api.box/api-key) to obtain your API Key\n\n## Usage\n\nAdd to request headers:\n\n```\nAuthorization: Bearer YOUR_API_KEY\n```\n\n> **⚠️ Note:**\n> - Keep your API Key secure and do not share it with others\n> - If you suspect your API Key has been compromised, reset it immediately from the management page","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"# 🔑 API Authentication\n\nAll endpoints require authentication using Bearer Token.\n\n## Get API Key\n\n1. Visit the [API Key Management Page](https://api.box/api-key) to obtain your API Key\n\n## Usage\n\nAdd to request headers:\n\n```\nAuthorization: Bearer YOUR_API_KEY\n```\n\n> **⚠️ Note:**\n> - Keep your API Key secure and do not share it with others\n> - If you suspect your API Key has been compromised, reset it immediately from the management page","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"suno-api/suno-api.json"},"subdomain":"apibox-ba51f6c3","siteName":"API Box","title":"Generate Mashup - API Box","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/suno-api/generate-mashup","matchLevel":0},"cn":{"href":"/cn/suno-api/generate-mashup","matchLevel":1}}},"lastModified":"2026-09-22T10:44:14.674Z","originalFileLocation":"suno-api/generate-mashup.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Mix two audio files to generate a new mashup work using AI models.\">\u003cmeta data-mint-head name=\"application-name\" content=\"API Box\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/apibox-ba51f6c3/tAXxfaC0Kjsi2Gb_/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/apibox-ba51f6c3/tAXxfaC0Kjsi2Gb_/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/apibox-ba51f6c3/tAXxfaC0Kjsi2Gb_/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/apibox-ba51f6c3/tAXxfaC0Kjsi2Gb_/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/apibox-ba51f6c3/tAXxfaC0Kjsi2Gb_/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/apibox-ba51f6c3/tAXxfaC0Kjsi2Gb_/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/apibox-ba51f6c3/tAXxfaC0Kjsi2Gb_/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/apibox-ba51f6c3/tAXxfaC0Kjsi2Gb_/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/apibox-ba51f6c3/tAXxfaC0Kjsi2Gb_/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Generate Mashup - API Box\">\u003cmeta data-mint-head property=\"og:description\" content=\"Mix two audio files to generate a new mashup work using AI models.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"API Box\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.api.box/suno-api/generate-mashup\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://apibox-ba51f6c3.mintlify.site/_mintlify/api/og/v2?division=Generate+Music\u0026amp;title=Generate+Mashup\u0026amp;description=Mix+two+audio+files+to+generate+a+new+mashup+work+using+AI+models.\u0026amp;theme=f4b002adaaf1f07b68b55944\u0026amp;signature=7003b601255c3d444b3c412b526d9494a19e7e6c4c0f6bd2f8a71b26f26a1c67\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Generate Mashup - API Box\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Mix two audio files to generate a new mashup work using AI models.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://apibox-ba51f6c3.mintlify.site/_mintlify/api/og/v2?division=Generate+Music\u0026amp;title=Generate+Mashup\u0026amp;description=Mix+two+audio+files+to+generate+a+new+mashup+work+using+AI+models.\u0026amp;theme=f4b002adaaf1f07b68b55944\u0026amp;signature=7003b601255c3d444b3c412b526d9494a19e7e6c4c0f6bd2f8a71b26f26a1c67\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/apibox-ba51f6c3/tAXxfaC0Kjsi2Gb_/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"API Box\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.api.box/suno-api/generate-mashup\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/suno-api/generate-mashup.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.api.box/suno-api/generate-mashup\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.api.box/cn/suno-api/generate-mashup\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.api.box/suno-api/generate-mashup\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.api.box/#organization\",\"name\":\"API Box\",\"url\":\"https://docs.api.box\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://api.box/logo.png\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.api.box#website\",\"name\":\"API Box\",\"url\":\"https://docs.api.box\",\"publisher\":{\"@id\":\"https://docs.api.box/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.api.box/suno-api/generate-mashup#webpage\",\"url\":\"https://docs.api.box/suno-api/generate-mashup\",\"name\":\"Generate Mashup\",\"description\":\"Mix two audio files to generate a new mashup work using AI models.\",\"dateModified\":\"2026-09-22T10:44:14.674Z\",\"isPartOf\":{\"@id\":\"https://docs.api.box#website\"},\"breadcrumb\":{\"@id\":\"https://docs.api.box/suno-api/generate-mashup#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.api.box/suno-api/generate-mashup#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Generate Music\",\"item\":\"https://docs.api.box/suno-api/generate-music\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Generate Mashup\",\"item\":\"https://docs.api.box/suno-api/generate-mashup\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.api.box/suno-api/generate-mashup#apireference\",\"headline\":\"Generate Mashup\",\"name\":\"Generate Mashup\",\"description\":\"Mix two audio files to generate a new mashup work using AI models.\",\"url\":\"https://docs.api.box/suno-api/generate-mashup\",\"mainEntityOfPage\":{\"@id\":\"https://docs.api.box/suno-api/generate-mashup#webpage\"},\"dateModified\":\"2026-09-22T10:44:14.674Z\",\"publisher\":{\"@id\":\"https://docs.api.box/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.api.box#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"API Box\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"API Box","nav":{"global":{"anchors":[{"anchor":"Home","icon":"house","href":"https://api.box/"}]},"languages":[{"language":"en","pages":[{"title":"API.box Documentation","icon":"music","href":""},{"title":"Quick Start","icon":"rocket","href":"/suno-api/quickstart"},{"group":"Generate Music","pages":[{"title":"Generate Music","openapi":"suno-api/suno-api.json POST /api/v1/generate","href":"/suno-api/generate-music"},{"title":"Music Generation Callbacks","href":"/suno-api/generate-music-callbacks"},{"title":"Extend Music","openapi":"suno-api/suno-api.json POST /api/v1/generate/extend","href":"/suno-api/extend-music"},{"title":"Music Extension Callbacks","href":"/suno-api/extend-music-callbacks"},{"title":"Upload And Cover Audio","openapi":"suno-api/suno-api.json POST /api/v1/generate/upload-cover","href":"/suno-api/upload-and-cover-audio"},{"title":"Upload and Cover Audio Callbacks","href":"/suno-api/upload-and-cover-audio-callbacks"},{"title":"Upload And Extend Audio","openapi":"suno-api/suno-api.json POST /api/v1/generate/upload-extend","href":"/suno-api/upload-and-extend-audio"},{"title":"Upload and Extend Audio Callbacks","href":"/suno-api/upload-and-extend-audio-callbacks"},{"title":"Add Instrumental","openapi":"suno-api/suno-api.json POST /api/v1/generate/add-instrumental","href":"/suno-api/add-instrumental"},{"title":"Add Instrumental Callbacks","href":"/suno-api/add-instrumental-callbacks"},{"title":"Add Vocals","openapi":"suno-api/suno-api.json POST /api/v1/generate/add-vocals","href":"/suno-api/add-vocals"},{"title":"Add Vocals Callbacks","href":"/suno-api/add-vocals-callbacks"},{"title":"Get Music Generation Details","openapi":"suno-api/suno-api.json GET /api/v1/generate/record-info","href":"/suno-api/get-music-generation-details"},{"title":"Recovery Audio","openapi":"suno-api/suno-api.json POST /api/v1/suno/recovery","href":"/suno-api/recovery-audio"},{"title":"Get Recovery Audio Details","openapi":"suno-api/suno-api.json GET /api/v1/suno/recovery/record-info","href":"/suno-api/get-recovery-audio-details"},{"title":"Get Timestamped Lyrics","openapi":"suno-api/suno-api.json POST /api/v1/generate/get-timestamped-lyrics","href":"/suno-api/get-timestamped-lyrics"},{"title":"Boost Music Style","openapi":"suno-api/suno-api.json POST /api/v1/style/generate","href":"/suno-api/boost-music-style"},{"title":"Generate Music Cover","openapi":"suno-api/suno-api.json POST /api/v1/suno/cover/generate","href":"/suno-api/cover-suno"},{"title":"Music Cover Generation Callbacks","href":"/suno-api/cover-suno-callbacks"},{"title":"Replace Music Section","openapi":"suno-api/suno-api.json POST /api/v1/generate/replace-section","href":"/suno-api/replace-section"},{"title":"Replace Music Section Callbacks","href":"/suno-api/replace-section-callbacks"},{"title":"Get Music Cover Details","openapi":"suno-api/suno-api.json GET /api/v1/suno/cover/record-info","href":"/suno-api/get-cover-suno-details"},{"title":"Generate Persona","description":"Create a personalized music Persona based on generated music, giving the music a unique identity and characteristics.","openapi":"suno-api/suno-api.json POST /api/v1/generate/generate-persona","href":"/suno-api/generate-persona"},{"title":"Generate Mashup","openapi":"suno-api/suno-api.json POST /api/v1/generate/mashup","href":"/suno-api/generate-mashup"}]},{"group":"Suno Voice","pages":[{"title":"Suno Voice Generate Verification Phrase","description":"Generate the validation phrase required for the Suno Voice custom voice workflow.","openapi":"suno-api/suno-voice-api.json POST /api/v1/voice/validate","href":"/suno-api/suno-voice-validate"},{"title":"Suno Voice Validation Phrase Callbacks","href":"/suno-api/suno-voice-validate-callbacks"},{"title":"Suno Voice Get Verification Phrase","openapi":"suno-api/suno-voice-api.json GET /api/v1/voice/validate-info","href":"/suno-api/suno-voice-validate-info"},{"title":"Suno Voice Create Custom Voice","openapi":"suno-api/suno-voice-api.json POST /api/v1/voice/generate","href":"/suno-api/suno-voice-generate"},{"title":"Suno Voice Generation Callbacks","href":"/suno-api/suno-voice-generate-callbacks"},{"title":"Suno Voice Get Custom Voice Record","openapi":"suno-api/suno-voice-api.json GET /api/v1/voice/record-info","href":"/suno-api/suno-voice-record-info"},{"title":"Suno Voice Regenerate Verification Phrase","openapi":"suno-api/suno-voice-api.json POST /api/v1/voice/regenerate","href":"/suno-api/suno-voice-regenerate"},{"title":"Suno Voice Regenerate Phrase Callbacks","href":"/suno-api/suno-voice-regenerate-callbacks"},{"title":"Suno Voice Check Availability","openapi":"suno-api/suno-voice-api.json POST /api/v1/voice/check-voice","href":"/suno-api/suno-voice-check-voice"}]},{"group":"Lyrics Generation","pages":[{"title":"Generate Lyrics","openapi":"suno-api/suno-api.json POST /api/v1/lyrics","href":"/suno-api/generate-lyrics"},{"title":"Lyrics Generation Callbacks","href":"/suno-api/generate-lyrics-callbacks"},{"title":"Get Lyrics Generation Details","openapi":"suno-api/suno-api.json GET /api/v1/lyrics/record-info","href":"/suno-api/get-lyrics-generation-details"}]},{"group":"Generate Sounds","pages":[{"title":"Generate Sounds","openapi":"suno-api/suno-api.json POST /api/v1/generate/sounds","href":"/suno-api/generate-sounds"}]},{"group":"WAV Conversion","pages":[{"title":"Convert to WAV Format","openapi":"suno-api/suno-api.json POST /api/v1/wav/generate","href":"/suno-api/convert-to-wav-format"},{"title":"WAV Format Conversion Callbacks","href":"/suno-api/convert-to-wav-format-callbacks"},{"title":"Get WAV Conversion Details","openapi":"suno-api/suno-api.json GET /api/v1/wav/record-info","href":"/suno-api/get-wav-conversion-details"}]},{"group":"Vocal Removal","pages":[{"title":"Vocal and Instrument Separation","openapi":"suno-api/suno-api.json POST /api/v1/vocal-removal/generate","href":"/suno-api/separate-vocals-from-music"},{"title":"Audio Separation Callbacks","href":"/suno-api/separate-vocals-from-music-callbacks"},{"title":"Get Audio Separation Details","openapi":"suno-api/suno-api.json GET /api/v1/vocal-removal/record-info","href":"/suno-api/get-vocal-separation-details"},{"title":"Generate MIDI from Audio","openapi":"suno-api/suno-api.json POST /api/v1/midi/generate","href":"/suno-api/generate-midi"},{"title":"MIDI Generation Callbacks","href":"/suno-api/generate-midi-callbacks"},{"title":"Get MIDI Generation Details","openapi":"suno-api/suno-api.json GET /api/v1/midi/record-info","href":"/suno-api/get-midi-details"}]},{"group":"Music Video Generation","pages":[{"title":"Create Music Video","openapi":"suno-api/suno-api.json POST /api/v1/mp4/generate","href":"/suno-api/create-music-video"},{"title":"Music Video Generation Callbacks","href":"/suno-api/create-music-video-callbacks"},{"title":"Get Music Video Details","openapi":"suno-api/suno-api.json GET /api/v1/mp4/record-info","href":"/suno-api/get-music-video-details"}]},{"group":"Account Management","pages":[{"title":"Get Remaining Credits","openapi":"suno-api/suno-api.json GET /api/v1/generate/credit","href":"/suno-api/get-remaining-credits"}]},{"group":"File Upload API","pages":[{"title":"File Upload API Quickstart","icon":"rocket","href":"/file-upload-api/quickstart"},{"title":"Base64 File Upload","openapi":"file-upload-api/file-upload-api.json POST /api/file-base64-upload","href":"/file-upload-api/upload-file-base-64"},{"openapi":"file-upload-api/file-upload-api.json POST /api/file-stream-upload","title":"File Stream Upload","href":"/file-upload-api/upload-file-stream"},{"openapi":"file-upload-api/file-upload-api.json POST /api/file-url-upload","title":"URL File Upload","href":"/file-upload-api/upload-file-url"}]}]},{"language":"cn","pages":[{"title":"cn","href":"/cn/suno-api/generate-mashup"}]}]},"basePath":"","title":"Generate Mashup - API Box","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}