{
"error": {
"message": "Too many requests, please try again later",
"type": "rix_api_error"
}
}
You can also submit through the unified task endpoint POST /v1/task/submit with model set to suno/upload and the parameters inside input. Both behave and bill the same.
Task result
What the fetch result holds once the task succeeds
When the task succeeds, the result is in data.result:
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"ePhone AI Docs","colors":{"primary":"#3B82F6","light":"#F8FAFC","dark":"#0F172A"},"favicon":"https://mintcdn.com/ephoneai/u0mzFW_MkYhtLUWA/images/logo-rix.png?fit=max\u0026auto=format\u0026n=u0mzFW_MkYhtLUWA\u0026q=85\u0026s=a6572e389f1b16ae5fc5cf8039a40d57","api":{"playground":{"display":"interactive","proxy":false},"examples":{"defaults":"required","languages":["curl","python","javascript","go"],"prefill":true}},"appearance":{"default":"system","strict":false},"navbar":{"links":[{"href":"https://platform.ephone.ai/models","label":"Models"},{"href":"https://platform.ephone.ai/chat","label":"Playground"}],"primary":{"type":"button","label":"Get started","href":"https://platform.ephone.ai/dashboard"}},"errors":{"404":{"redirect":false,"title":"I can't be found","description":"What ever **happened** to this _page_?"}},"contextual":{"options":["copy","chatgpt","claude"],"display":"header"},"styling":{"latex":true},"navigation":{"languages":[{"language":"en","default":true,"href":"en/guides/quickstart"},{"language":"cn","href":"cn/guides/quickstart"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ephoneai","hasAudioNarration":false,"actualSubdomain":"ephoneai","customDomains":["docs.rixapi.com"],"gitSource":{"type":"github","owner":"rixapi","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"issues":false},"entitlements":{},"buildId":"6aec3d9a37327199c83b8297","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"cn","tag":"API 参考","count":39},{"language":"cn","tag":"模型接口","count":39},{"language":"en","tag":"API Reference","count":39},{"language":"en","tag":"Model APIs","count":39},{"language":"cn","tag":"Suno","count":30},{"language":"en","tag":"Suno","count":30},{"language":"cn","tag":"用户指南","count":17},{"language":"en","tag":"User Guide","count":17},{"language":"cn","tag":"场景示例","count":14},{"language":"en","tag":"Use Cases","count":14},{"language":"cn","tag":"开发工具\u0026平台","count":10},{"language":"en","tag":"Development Tools \u0026 Platforms","count":10},{"language":"cn","tag":"Midjourney","count":9},{"language":"cn","tag":"使用指南","count":9},{"language":"en","tag":"Midjourney","count":9},{"language":"en","tag":"Usage Guide","count":9},{"language":"cn","tag":"改已有的曲子","count":7},{"language":"en","tag":"Work on an existing track","count":7},{"language":"cn","tag":"生成新曲","count":6},{"language":"en","tag":"Create something new","count":6}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"en/api-reference/suno/upload","slug":"/en/api-reference/suno/upload","pageMetadata":{"title":"Audio Upload","description":"Upload audio so other actions can reference it.","openapi":"en/openapi/suno.json POST /suno/v2/upload","href":"/en/api-reference/suno/upload"},"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: \"Upload audio so other actions can reference it.\"\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`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{Accordion,CodeBlock,Tip}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Tip,{children:_jsxs(_components.p,{children:[`You can also submit through the unified task endpoint `,_jsx(_components.code,{children:`POST /v1/task/submit`}),` with `,_jsx(_components.code,{children:`model`}),` set to `,_jsx(_components.code,{children:`suno/upload`}),` and the parameters inside `,_jsx(_components.code,{children:`input`}),`. Both behave and bill the same.`]})}),`\n`,_jsxs(Accordion,{title:`Task result`,description:`What the fetch result holds once the task succeeds`,icon:`list-check`,id:`task-result`,children:[_jsxs(_components.p,{children:[`When the task succeeds, the result is in `,_jsx(_components.code,{children:`data.result`}),`:`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`13`,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:`13`,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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"success\"`}),_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:` \"data\"`}),_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:` \"task_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"5adac6ee-...\"`}),_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:` \"action\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"upload\"`}),_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:`\"suno/upload\"`}),_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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"SUCCESS\"`}),_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:` \"progress\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"100%\"`}),_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:` \"result\"`}),_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:` \"music_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"89b20862-...\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsxs(_components.p,{children:[_jsx(_components.code,{children:`result.music_id`}),` is the ID of the uploaded track. Upload cover, upload extend, reference generation and other actions can use it directly.`]})]})]})}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":"Audio Upload","description":"Upload audio so other actions can reference it.","openapi":"en/openapi/suno.json POST /suno/v2/upload","href":"/en/api-reference/suno/upload"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"suno_upload","summary":"Audio Upload","description":"Upload audio so other actions can reference it.","requestBody":"393be039-2e87-437b-8038-90b324622f3e","responses":{"200":"7a6c8bc1-17ef-429a-bf33-00bbf94c927f","400":"954ad3e4-d2c0-48b6-9f94-7333b71be9d9","401":"a94f7001-a2db-4cb0-bb61-42953be45dee","429":"d9c9b128-5b91-4cb1-8a6e-e13f544c5377"},"method":"post","type":"path","servers":["04214783-fe21-40e1-a258-a88c4817b2e9"],"security":["2ecdd3ee-c9e4-4c6f-a30d-22014987882e"],"path":"/suno/v2/upload","baseUrlOptions":["https://api.ephone.ai"],"title":"Audio Upload","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","go"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.audio_url":"https://example.com/audio.mp3"}],"disableProxy":true},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"audio_url":{"type":"string","description":"**Audio URL**: A publicly downloadable audio URL. Eight minutes or less recommended. MP3, WAV, or M4A.","isRequired":true,"uniqueKey":"audio_url","typeLabel":"string"},"is_async":{"type":"boolean","default":false,"description":"**Async**: Return a task ID immediately and fetch the result later. Off waits for completion.","uniqueKey":"is_async","typeLabel":"boolean"},"notify_hook":{"type":"string","format":"uri","description":"**Notify hook**: when the task ends, the same content as the fetch result is POSTed to this URL (a public http / https URL). Omit it to poll instead.","uniqueKey":"notify_hook","typeLabel":"string\u003curi>"}},"required":["audio_url"],"uniqueKey":"","typeLabel":"object"},"example":{"audio_url":"https://example.com/audio.mp3"},"examples":{"Example":{"title":"Example","value":{"audio_url":"https://example.com/audio.mp3"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"7a6c8bc1-17ef-429a-bf33-00bbf94c927f":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["success"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"data":{"type":"object","properties":{"task_id":{"type":"string","description":"Task ID.","isRequired":true,"uniqueKey":"data.task_id","typeLabel":"string"}},"required":["task_id"],"isRequired":true,"uniqueKey":"data","typeLabel":"object"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"required":["code","data"],"uniqueKey":"","typeLabel":"object"},"example":{"code":"success","message":"success","data":{"task_id":"5adac6ee-..."}},"examples":{"Example":{"title":"Example","value":{"code":"success","message":"success","data":{"task_id":"5adac6ee-..."}}}},"exampleType":"examples"}},"exampleType":"examples"},"954ad3e4-d2c0-48b6-9f94-7333b71be9d9":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":"error","message":"music_id is required"},"examples":{"Example":{"title":"Example","value":{"code":"error","message":"music_id is required"}}},"exampleType":"examples"}},"exampleType":"examples"},"a94f7001-a2db-4cb0-bb61-42953be45dee":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","uniqueKey":"error.type","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"message":"Invalid Token","type":"rix_api_error"}},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Invalid Token","type":"rix_api_error"}}}},"exampleType":"examples"}},"exampleType":"examples"},"d9c9b128-5b91-4cb1-8a6e-e13f544c5377":{"description":"Too Many Requests","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","uniqueKey":"error.type","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"message":"Too many requests, please try again later","type":"rix_api_error"}},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Too many requests, please try again later","type":"rix_api_error"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"2ecdd3ee-c9e4-4c6f-a30d-22014987882e":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Send your API key in the `Authorization: Bearer YOUR_API_KEY` header.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"04214783-fe21-40e1-a258-a88c4817b2e9":{"url":"https://api.ephone.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Send your API key in the `Authorization: Bearer YOUR_API_KEY` header.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Send your API key in the `Authorization: Bearer YOUR_API_KEY` header.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"en/openapi/suno.json"},"subdomain":"ephoneai","siteName":"ePhone AI Docs","title":"Audio Upload - ePhone AI Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/en/api-reference/suno/upload","matchLevel":0},"cn":{"href":"/cn/api-reference/suno/upload","matchLevel":1}}},"lastModified":"2026-10-17T22:10:02.895Z","originalFileLocation":"en/api-reference/suno/upload.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=\"Upload audio so other actions can reference it.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ePhone AI Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/ephoneai/GTn4H3icXyous-T1/_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=\"/docs/mintlify-assets/_mintlify/favicons/ephoneai/GTn4H3icXyous-T1/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/ephoneai/GTn4H3icXyous-T1/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/ephoneai/GTn4H3icXyous-T1/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/ephoneai/GTn4H3icXyous-T1/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/ephoneai/GTn4H3icXyous-T1/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/ephoneai/GTn4H3icXyous-T1/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/ephoneai/GTn4H3icXyous-T1/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/ephoneai/GTn4H3icXyous-T1/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Audio Upload - ePhone AI Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Upload audio so other actions can reference it.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ePhone AI Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.rixapi.com/docs/en/api-reference/suno/upload\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ephoneai.mintlify.site/docs/_mintlify/api/og/v2?division=Bring+your+own+audio\u0026amp;title=Audio+Upload\u0026amp;description=Upload+audio+so+other+actions+can+reference+it.\u0026amp;theme=753d0dc97b34436e10bf60b7\u0026amp;signature=c063eefc1f04b4f98930ff7f61962cc8d10da9686d975a20c55532484443df3f\">\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=\"Audio Upload - ePhone AI Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Upload audio so other actions can reference it.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ephoneai.mintlify.site/docs/_mintlify/api/og/v2?division=Bring+your+own+audio\u0026amp;title=Audio+Upload\u0026amp;description=Upload+audio+so+other+actions+can+reference+it.\u0026amp;theme=753d0dc97b34436e10bf60b7\u0026amp;signature=c063eefc1f04b4f98930ff7f61962cc8d10da9686d975a20c55532484443df3f\">\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=\"/docs/mintlify-assets/_mintlify/favicons/ephoneai/GTn4H3icXyous-T1/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ePhone AI Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3B82F6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.rixapi.com/docs/en/api-reference/suno/upload\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/en/api-reference/suno/upload.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.rixapi.com/docs/en/api-reference/suno/upload\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.rixapi.com/docs/cn/api-reference/suno/upload\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.rixapi.com/docs/en/api-reference/suno/upload\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.rixapi.com/#organization\",\"name\":\"ePhone AI Docs\",\"url\":\"https://docs.rixapi.com\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.rixapi.com/docs#website\",\"name\":\"ePhone AI Docs\",\"url\":\"https://docs.rixapi.com/docs\",\"publisher\":{\"@id\":\"https://docs.rixapi.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.rixapi.com/docs/en/api-reference/suno/upload#webpage\",\"url\":\"https://docs.rixapi.com/docs/en/api-reference/suno/upload\",\"name\":\"Audio Upload\",\"description\":\"Upload audio so other actions can reference it.\",\"dateModified\":\"2026-10-17T22:10:02.895Z\",\"isPartOf\":{\"@id\":\"https://docs.rixapi.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://docs.rixapi.com/docs/en/api-reference/suno/upload#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.rixapi.com/docs/en/api-reference/suno/upload#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Model APIs\",\"item\":\"https://docs.rixapi.com/docs/en/api-reference/suno/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Suno\",\"item\":\"https://docs.rixapi.com/docs/en/api-reference/suno/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Audio Upload\",\"item\":\"https://docs.rixapi.com/docs/en/api-reference/suno/upload\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.rixapi.com/docs/en/api-reference/suno/upload#apireference\",\"headline\":\"Audio Upload\",\"name\":\"Audio Upload\",\"description\":\"Upload audio so other actions can reference it.\",\"url\":\"https://docs.rixapi.com/docs/en/api-reference/suno/upload\",\"mainEntityOfPage\":{\"@id\":\"https://docs.rixapi.com/docs/en/api-reference/suno/upload#webpage\"},\"dateModified\":\"2026-10-17T22:10:02.895Z\",\"publisher\":{\"@id\":\"https://docs.rixapi.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.rixapi.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ePhone AI Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"ePhone AI Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/en/api-reference/suno/upload.md","siteName":"ePhone AI Docs","nav":{"global":null,"languages":[{"language":"en","default":true,"tabs":[{"tab":"User Guide","pages":[{"title":"User Guide","href":"/en/guides/quickstart"}]},{"tab":"API Reference","groups":[{"group":"Model APIs","pages":[{"group":"Suno","icon":"/images/icons/suno.svg","pages":[{"title":"Suno API Overview","sidebarTitle":"Suno API Overview","icon":"book-open","href":"/en/api-reference/suno/overview"},{"group":"Create something new","pages":[{"title":"Music Generation","openapi":"en/openapi/suno.json POST /suno/v2/music","href":"/en/api-reference/suno/music"},{"title":"Lyric Writing","openapi":"en/openapi/suno.json POST /suno/v2/lyrics","href":"/en/api-reference/suno/lyrics"},{"title":"Sound Effects","openapi":"en/openapi/suno.json POST /suno/v2/sounds","href":"/en/api-reference/suno/sounds"},{"title":"Reference Generation","openapi":"en/openapi/suno.json POST /suno/v2/inspo","href":"/en/api-reference/suno/inspo"},{"title":"Sample Rework","openapi":"en/openapi/suno.json POST /suno/v2/sample","href":"/en/api-reference/suno/sample"},{"title":"Mashup","openapi":"en/openapi/suno.json POST /suno/v2/mashup","href":"/en/api-reference/suno/mashup"}]},{"group":"Work on an existing track","pages":[{"title":"Extension","openapi":"en/openapi/suno.json POST /suno/v2/extend","href":"/en/api-reference/suno/extend"},{"title":"Cover","openapi":"en/openapi/suno.json POST /suno/v2/cover","href":"/en/api-reference/suno/cover"},{"title":"Remaster","openapi":"en/openapi/suno.json POST /suno/v2/remaster","href":"/en/api-reference/suno/remaster"},{"title":"Section Rewrite","openapi":"en/openapi/suno.json POST /suno/v2/replace-section","href":"/en/api-reference/suno/replace-section"},{"title":"Add Vocals","openapi":"en/openapi/suno.json POST /suno/v2/add-vocals","href":"/en/api-reference/suno/add-vocals"},{"title":"Add Instrumental","openapi":"en/openapi/suno.json POST /suno/v2/add-instrumental","href":"/en/api-reference/suno/add-instrumental"},{"title":"Stem Layering","description":"Layer an additional instrument track onto an existing song.","openapi":"en/openapi/suno.json POST /suno/v2/add-stem","href":"/en/api-reference/suno/add-stem"}]},{"group":"Bring your own audio","pages":[{"title":"Audio Upload","openapi":"en/openapi/suno.json POST /suno/v2/upload","href":"/en/api-reference/suno/upload"},{"title":"Upload \u0026 Cover","description":"Upload your own audio and re-perform it in a new style.","openapi":"en/openapi/suno.json POST /suno/v2/upload-cover","href":"/en/api-reference/suno/upload-cover"},{"title":"Upload \u0026 Extend","openapi":"en/openapi/suno.json POST /suno/v2/upload-extend","href":"/en/api-reference/suno/upload-extend"}]},{"group":"Split and reassemble","pages":[{"title":"Vocal Separation","openapi":"en/openapi/suno.json POST /suno/v2/stems","href":"/en/api-reference/suno/stems"},{"title":"Full Stem Separation","openapi":"en/openapi/suno.json POST /suno/v2/stems-all","href":"/en/api-reference/suno/stems-all"},{"title":"Segment Merge","openapi":"en/openapi/suno.json POST /suno/v2/concat","href":"/en/api-reference/suno/concat"}]},{"group":"Adjust and export","pages":[{"title":"Speed Adjustment","openapi":"en/openapi/suno.json POST /suno/v2/adjust-speed","href":"/en/api-reference/suno/adjust-speed"},{"title":"Multi-format Export","openapi":"en/openapi/suno.json POST /suno/v2/download","href":"/en/api-reference/suno/download"},{"title":"MIDI Export","openapi":"en/openapi/suno.json POST /suno/v2/gen-midi","href":"/en/api-reference/suno/gen-midi"}]},{"group":"Voices and models","pages":[{"title":"Voice Capture","openapi":"en/openapi/suno.json POST /suno/v2/persona","href":"/en/api-reference/suno/persona"},{"title":"Voice Cloning","openapi":"en/openapi/suno.json POST /suno/v2/create-voice","href":"/en/api-reference/suno/create-voice"},{"title":"Model Training","openapi":"en/openapi/suno.json POST /suno/v2/create-model","href":"/en/api-reference/suno/create-model"}]},{"group":"Analysis","pages":[{"title":"Lyric Timings","openapi":"en/openapi/suno.json POST /suno/v2/aligned-lyrics","href":"/en/api-reference/suno/aligned-lyrics"},{"title":"Style Expansion","openapi":"en/openapi/suno.json POST /suno/v2/upsample-tags","href":"/en/api-reference/suno/upsample-tags"}]},{"group":"Fetch","pages":[{"title":"Get Task","openapi":"en/openapi/suno.json GET /suno/v2/fetch/{task_id}","href":"/en/api-reference/suno/fetch"},{"title":"Batch Get Tasks","openapi":"en/openapi/suno.json POST /suno/v2/fetch","href":"/en/api-reference/suno/fetch-batch"}]}]},{"group":"Midjourney","icon":"/images/icons/midjourney.svg","pages":[{"title":"Midjourney API Overview","sidebarTitle":"Midjourney API Overview","icon":"book-open","href":"/en/api-reference/midjourney/overview"},{"title":"Imagine","openapi":"en/openapi/midjourney.json POST /midjourney/imagine","href":"/en/api-reference/midjourney/imagine"},{"title":"Blend","openapi":"en/openapi/midjourney.json POST /midjourney/blend","href":"/en/api-reference/midjourney/blend"},{"title":"Describe","openapi":"en/openapi/midjourney.json POST /midjourney/describe","href":"/en/api-reference/midjourney/describe"},{"title":"Edit","openapi":"en/openapi/midjourney.json POST /midjourney/edit","href":"/en/api-reference/midjourney/edit"},{"title":"Retexture","openapi":"en/openapi/midjourney.json POST /midjourney/retexture","href":"/en/api-reference/midjourney/retexture"},{"title":"Image to Video","openapi":"en/openapi/midjourney.json POST /midjourney/video","href":"/en/api-reference/midjourney/video"},{"title":"Image Actions","openapi":"en/openapi/midjourney.json POST /midjourney/action","href":"/en/api-reference/midjourney/action"},{"title":"Get Task","openapi":"en/openapi/midjourney.json GET /midjourney/task/{task_id}","href":"/en/api-reference/midjourney/task"}]}]}]},{"tab":"Admin Key","pages":[{"title":"Admin Key","href":"/en/admin-key/introduction"}]},{"tab":"Use Cases","pages":[{"title":"Use Cases","href":"/en/usercases/openclaw"}]},{"tab":"FAQs","pages":[{"title":"FAQs","href":"/en/faqs/error"}]}]},{"language":"cn","pages":[{"title":"cn","href":"/cn/api-reference/suno/upload"}]}]},"basePath":"","title":"Audio Upload - ePhone AI Docs","buildId":"dpl_2AK98Hxhwu4fUXpx9atbv41cC328","deploymentId":"dpl_2AK98Hxhwu4fUXpx9atbv41cC328","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-EBSrFTg1.js","utils-Y_7TcRh4.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D1wvvkPH.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-aT0ty6oN.js","snippetPresets-DoNRuyJc.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-CXRajFpn.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BAyOsINj.js","shallow-CIcHqV1v.js","getApiPlaygroundDisplay-C5igZwEf.js","CodeSnippet-BFWnQLNh.js","CodeSnippets-Cx2mFgZW.js","Page-DCFaZE46.js","getPastedJson-BOy09PZp.js","icon-BwmYtB6R.js","MethodPill-DAIhq-iu.js","DuplicateIcon-DFM8Q3ph.js","createIcon-0UdvzB4Z.js","DynamicMarkdown-DYYZTGpa.js","SectionHeading-BFCDRUuH.js","axios-vUo_bRtp.js","Markdown-C6TcKjiR.js","clsx-Y_UC780V.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-PCbBHBTv.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-D4q_oRML.js"]}