{
"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/lyrics 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, data.lyrics holds two lyric drafts. Pick one and pass it as prompt when generating a song.
{"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/lyrics","slug":"/en/api-reference/suno/lyrics","pageMetadata":{"title":"Lyric Writing","description":"Write lyrics from a theme. Returns two drafts.","openapi":"en/openapi/suno.json POST /suno/v2/lyrics","href":"/en/api-reference/suno/lyrics"},"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: \"Write lyrics from a theme. Returns two drafts.\"\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,ResponseField,Tip}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,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/lyrics`}),` 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, `,_jsx(_components.code,{children:`data.lyrics`}),` holds two lyric drafts. Pick one and pass it as `,_jsx(_components.code,{children:`prompt`}),` when generating a song.`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`22`,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:`22`,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:`\"lyrics\"`}),_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/lyrics\"`}),_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:` \"lyrics\"`}),_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.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:`\"Tin Roof 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:` \"text\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"[Verse 1]`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\n`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},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:` \"tags\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"lo-fi, mellow\"`})]}),`\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.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:`\"...\"`}),_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:` \"text\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},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:` \"tags\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},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`,_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(ResponseField,{name:`title`,type:`string`,id:`param-title`,children:_jsx(_components.p,{children:`Suggested title.`})}),_jsx(ResponseField,{name:`text`,type:`string`,required:true,id:`param-text`,children:_jsx(_components.p,{children:`Lyrics, with section markers such as [Verse] and [Chorus].`})}),_jsx(ResponseField,{name:`tags`,type:`string`,id:`param-tags`,children:_jsx(_components.p,{children:`Suggested style tags.`})})]})]})}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":"Lyric Writing","description":"Write lyrics from a theme. Returns two drafts.","openapi":"en/openapi/suno.json POST /suno/v2/lyrics","href":"/en/api-reference/suno/lyrics"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"suno_lyrics","summary":"Lyric Writing","description":"Write lyrics from a theme. Returns two drafts.","requestBody":"9718be54-469f-4f0f-b49b-3d431fa5adf7","responses":{"200":"4a395a10-890b-43eb-90fd-a935f06ca736","400":"72f03f28-7afd-4c02-86b6-f3cc478e74f0","401":"d97ce53c-839e-4bdb-9ce7-7f56bc04b68c","429":"05d3c58b-a50b-499d-880e-74cfe1dae864"},"method":"post","type":"path","servers":["04214783-fe21-40e1-a258-a88c4817b2e9"],"security":["2ecdd3ee-c9e4-4c6f-a30d-22014987882e"],"path":"/suno/v2/lyrics","baseUrlOptions":["https://api.ephone.ai"],"title":"Lyric Writing","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","go"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.prompt":"[Verse 1]\nRain on the tin roof"}],"disableProxy":true},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","description":"**Lyrics**: Full lyrics, up to 5000 characters. Use markers like [Verse] and [Chorus] to shape the structure.","isRequired":true,"uniqueKey":"prompt","typeLabel":"string"},"lyrics_model":{"type":"string","enum":["classic","remi"],"default":"classic","description":"**Lyric Style**: Which lyric writing approach to use. Options: `classic` Classic; `remi` Remi.","uniqueKey":"lyrics_model","typeLabel":"enum\u003cstring>"},"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":["prompt"],"uniqueKey":"","typeLabel":"object"},"example":{"prompt":"[Verse 1]\nRain on the tin roof"},"examples":{"Example":{"title":"Example","value":{"prompt":"[Verse 1]\nRain on the tin roof"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"4a395a10-890b-43eb-90fd-a935f06ca736":{"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"},"72f03f28-7afd-4c02-86b6-f3cc478e74f0":{"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"},"d97ce53c-839e-4bdb-9ce7-7f56bc04b68c":{"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"},"05d3c58b-a50b-499d-880e-74cfe1dae864":{"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":"Lyric Writing - ePhone AI Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/en/api-reference/suno/lyrics","matchLevel":0},"cn":{"href":"/cn/api-reference/suno/lyrics","matchLevel":1}}},"lastModified":"2026-10-17T22:10:02.873Z","originalFileLocation":"en/api-reference/suno/lyrics.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=\"Write lyrics from a theme. Returns two drafts.\">\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=\"Lyric Writing - ePhone AI Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Write lyrics from a theme. Returns two drafts.\">\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/lyrics\">\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=Create+something+new\u0026amp;title=Lyric+Writing\u0026amp;description=Write+lyrics+from+a+theme.+Returns+two+drafts.\u0026amp;theme=753d0dc97b34436e10bf60b7\u0026amp;signature=4a02446bd6b6a1657499b34d2600bdbbb4f9333b9a39498872644e37754a79bf\">\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=\"Lyric Writing - ePhone AI Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Write lyrics from a theme. Returns two drafts.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ephoneai.mintlify.site/docs/_mintlify/api/og/v2?division=Create+something+new\u0026amp;title=Lyric+Writing\u0026amp;description=Write+lyrics+from+a+theme.+Returns+two+drafts.\u0026amp;theme=753d0dc97b34436e10bf60b7\u0026amp;signature=4a02446bd6b6a1657499b34d2600bdbbb4f9333b9a39498872644e37754a79bf\">\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/lyrics\">\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/lyrics.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.rixapi.com/docs/en/api-reference/suno/lyrics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.rixapi.com/docs/cn/api-reference/suno/lyrics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.rixapi.com/docs/en/api-reference/suno/lyrics\">\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/lyrics#webpage\",\"url\":\"https://docs.rixapi.com/docs/en/api-reference/suno/lyrics\",\"name\":\"Lyric Writing\",\"description\":\"Write lyrics from a theme. Returns two drafts.\",\"dateModified\":\"2026-10-17T22:10:02.873Z\",\"isPartOf\":{\"@id\":\"https://docs.rixapi.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://docs.rixapi.com/docs/en/api-reference/suno/lyrics#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.rixapi.com/docs/en/api-reference/suno/lyrics#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\":\"Create something new\",\"item\":\"https://docs.rixapi.com/docs/en/api-reference/suno/music\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Lyric Writing\",\"item\":\"https://docs.rixapi.com/docs/en/api-reference/suno/lyrics\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.rixapi.com/docs/en/api-reference/suno/lyrics#apireference\",\"headline\":\"Lyric Writing\",\"name\":\"Lyric Writing\",\"description\":\"Write lyrics from a theme. Returns two drafts.\",\"url\":\"https://docs.rixapi.com/docs/en/api-reference/suno/lyrics\",\"mainEntityOfPage\":{\"@id\":\"https://docs.rixapi.com/docs/en/api-reference/suno/lyrics#webpage\"},\"dateModified\":\"2026-10-17T22:10:02.873Z\",\"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/lyrics.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","description":"Generate a full song from a one-line idea or your own lyrics. Returns two takes.","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","description":"Generate one-shot or looping sound effects, with optional BPM and key.","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","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","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/lyrics"}]}]},"basePath":"","title":"Lyric Writing - 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"]}