Train a custom AI singer persona from an existing vocal clip, then use it to generate music with a consistent vocal style
Endpoint
POST /api/v1/music/persona
Creates a reusable AI singer persona from an existing clip. Once created, pass the returned persona_id to Generate Music to apply the vocal style to any new track.
Request body
Field
Type
Required
Description
name
string
Yes
Display name for the persona (e.g. "My Artist" or "我的歌手").
persona_id works with both custom mode (prompt + tags) and inspiration mode (gpt_description_prompt). The vocal style is applied regardless of which generation mode you choose.
Complete workflow
1. Record or generate a source clip with the target vocal style ↓2. (Recommended) Run Stem Separation to isolate clean vocals ↓3. POST /api/v1/music/persona → receive persona_id ↓4. POST /api/v1/music/generate + persona_id → task_id ↓5. Poll GET /api/v1/task/{task_id} → audio_url
Run Stem Separation on a clip first to get a clean vocal track, then use that vocal audio as the source for persona creation.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"MusicMint - AI Music API","colors":{"primary":"#16A34A","light":"#4ADE80","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/zlch/f6feGuaFmX6fjNh7/logo/light.svg?fit=max\u0026auto=format\u0026n=f6feGuaFmX6fjNh7\u0026q=85\u0026s=e19ca3874c6820076279a42016f8b9ee","dark":"https://mintcdn.com/zlch/f6feGuaFmX6fjNh7/logo/dark.svg?fit=max\u0026auto=format\u0026n=f6feGuaFmX6fjNh7\u0026q=85\u0026s=29bef869505bfd28367d8ec56f271e2d"},"favicon":"/favicon.ico","navbar":{"links":[{"href":"mailto:support@example.com","label":"Support"}]},"footer":{"socials":{}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"API Reference","icon":"code","href":"/api-reference/introduction"}]},"languages":[{"language":"en","href":""},{"language":"zh","href":"zh"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"zlch","hasAudioNarration":false,"actualSubdomain":"zlch","customDomains":["docs.musicmint.ai"],"gitSource":{"type":"github","owner":"zlch-oceanai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae94a3d3da74a958a8fc58c:success","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"en","tag":"Music Generation","count":10},{"language":"zh","tag":"音乐生成","count":10},{"language":"en","tag":"Audio Processing","count":5},{"language":"zh","tag":"音频处理","count":5},{"language":"en","tag":"Overview","count":3},{"language":"en","tag":"Tasks \u0026 Results","count":3},{"language":"zh","tag":"概述","count":3},{"language":"zh","tag":"任务与结果","count":3},{"language":"en","tag":"Getting Started","count":2},{"language":"zh","tag":"快速上手","count":2},{"language":"en","tag":"Lyrics","count":1},{"language":"en","tag":"AI Singer (Persona)","count":1},{"language":"zh","tag":"歌词","count":1},{"language":"zh","tag":"AI 歌手(Persona)","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","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":"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":"site-roles","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":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/persona/create","slug":"/api-reference/persona/create","pageMetadata":{"title":"Create AI Singer (Persona)","description":"Train a custom AI singer persona from an existing vocal clip, then use it to generate music with a consistent vocal style","href":"/api-reference/persona/create","hidden":false},"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: \"Train a custom AI singer persona from an existing vocal clip, then use it to generate music with a consistent vocal style\"\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={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`endpoint`,children:`Endpoint`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`http`,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:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`POST`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` /api/v1/music/persona`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Creates a reusable AI singer persona from an existing clip. Once created, pass the returned `,_jsx(_components.code,{children:`persona_id`}),` to `,_jsx(_components.a,{href:`/api-reference/music/generate`,children:`Generate Music`}),` to apply the vocal style to any new track.`]}),`\n`,_jsx(Heading,{level:`2`,id:`request-body`,children:`Request body`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`name`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Yes`})}),_jsxs(_components.td,{children:[`Display name for the persona (e.g. `,_jsx(_components.code,{children:`\"My Artist\"`}),` or `,_jsx(_components.code,{children:`\"我的歌手\"`}),`).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`clip_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Yes`})}),_jsx(_components.td,{children:`Source clip ID whose vocal style will be learned.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`14`,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:`14`,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:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ok\"`}),_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:` \"request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"req-1710000000000\"`}),_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:` \"taskBatchId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"batch-xyz789\"`}),_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:` \"items\"`}),_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:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"persona-abc123\"`}),_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:`\"complete\"`})]}),`\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`]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`taskBatchId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Internal batch identifier`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`items`})}),_jsx(_components.td,{children:`array`}),_jsx(_components.td,{children:`Created persona items`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`items[].id`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Persona ID`}),` — pass this as `,_jsx(_components.code,{children:`persona_id`}),` in generation requests`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`items[].status`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`\"complete\"`}),` when persona is ready to use`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`using-your-persona-to-generate-music`,children:`Using your Persona to generate music`}),`\n`,_jsxs(_components.p,{children:[`Once you have a `,_jsx(_components.code,{children:`persona_id`}),`, pass it to any `,_jsx(_components.a,{href:`/api-reference/music/generate`,children:`Generate Music`}),` request. The AI will sing the generated track in the learned vocal style.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.example.com/api/v1/music/generate`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer sk-mm-your-key\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"prompt\": \"[Verse]\\\\n月光照在窗台\\\\n风轻轻吹来\\\\n[Chorus]\\\\n你是我心中的光\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"title\": \"心中的光\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"tags\": \"流行 抒情 女声\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"persona_id\": \"persona-abc123\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`persona_id`}),` works with both `,_jsx(_components.strong,{children:`custom mode`}),` (`,_jsx(_components.code,{children:`prompt`}),` + `,_jsx(_components.code,{children:`tags`}),`) and `,_jsx(_components.strong,{children:`inspiration mode`}),` (`,_jsx(_components.code,{children:`gpt_description_prompt`}),`). The vocal style is applied regardless of which generation mode you choose.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`complete-workflow`,children:`Complete workflow`}),`\n`,_jsx(CodeBlock,{numberOfLines:`10`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`1. Record or generate a source clip with the target vocal style`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ↓`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`2. (Recommended) Run Stem Separation to isolate clean vocals`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ↓`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`3. POST /api/v1/music/persona → receive persona_id`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ↓`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`4. POST /api/v1/music/generate + persona_id → task_id`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ↓`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`5. Poll GET /api/v1/task/{task_id} → audio_url`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`create-persona-example`,children:`Create persona example`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.example.com/api/v1/music/persona`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer sk-mm-your-key\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"name\": \"My Custom Singer\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"clip_id\": \"abc123def456\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`choosing-a-source-clip`,children:`Choosing a source clip`}),`\n`,_jsx(_components.p,{children:`For best results, use a clip with:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Clear, isolated vocals (minimal background noise)`}),`\n`,_jsx(_components.li,{children:`At least 30 seconds of vocal content`}),`\n`,_jsx(_components.li,{children:`A consistent vocal style throughout`}),`\n`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Run `,_jsx(_components.a,{href:`/api-reference/audio/stem`,children:`Stem Separation`}),` on a clip first to get a clean vocal track, then use that vocal audio as the source for persona creation.`]})})]})}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":"Create AI Singer (Persona)","description":"Train a custom AI singer persona from an existing vocal clip, then use it to generate music with a consistent vocal style","href":"/api-reference/persona/create","hidden":false}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Endpoint","slug":"endpoint","depth":2,"children":[]},{"title":"Request body","slug":"request-body","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Using your Persona to generate music","slug":"using-your-persona-to-generate-music","depth":2,"children":[]},{"title":"Complete workflow","slug":"complete-workflow","depth":2,"children":[]},{"title":"Create persona example","slug":"create-persona-example","depth":2,"children":[]},{"title":"Choosing a source clip","slug":"choosing-a-source-clip","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"zlch","siteName":"MusicMint - AI Music API","title":"Create AI Singer (Persona) - MusicMint - AI Music API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/persona/create","matchLevel":0},"zh":{"href":"/zh/api-reference/persona/create","matchLevel":1}}},"lastModified":"2026-03-17T08:38:50.921Z","originalFileLocation":"api-reference/persona/create.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=\"Train a custom AI singer persona from an existing vocal clip, then use it to generate music with a consistent vocal style\">\u003cmeta data-mint-head name=\"application-name\" content=\"MusicMint - AI Music API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/zlch/hy4hiyJRP-lsZkYo/_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/zlch/hy4hiyJRP-lsZkYo/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/zlch/hy4hiyJRP-lsZkYo/_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/zlch/hy4hiyJRP-lsZkYo/_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/zlch/hy4hiyJRP-lsZkYo/_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/zlch/hy4hiyJRP-lsZkYo/_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/zlch/hy4hiyJRP-lsZkYo/_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/zlch/hy4hiyJRP-lsZkYo/_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/zlch/hy4hiyJRP-lsZkYo/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create AI Singer (Persona) - MusicMint - AI Music API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Train a custom AI singer persona from an existing vocal clip, then use it to generate music with a consistent vocal style\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"MusicMint - AI Music API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.musicmint.ai/api-reference/persona/create\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://zlch.mintlify.site/_mintlify/api/og/v2?division=AI+Singer+%28Persona%29\u0026amp;title=Create+AI+Singer+%28Persona%29\u0026amp;description=Train+a+custom+AI+singer+persona+from+an+existing+vocal+clip%2C+then+use+it+to+generate+music+with+a+consistent+vocal+style\u0026amp;theme=2490766786df30fa53f34c48\u0026amp;signature=4bcfc6ad62d3dc78cae96cfed995d5616fee0455628f9b9c448a38590ae7322a\">\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=\"Create AI Singer (Persona) - MusicMint - AI Music API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Train a custom AI singer persona from an existing vocal clip, then use it to generate music with a consistent vocal style\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://zlch.mintlify.site/_mintlify/api/og/v2?division=AI+Singer+%28Persona%29\u0026amp;title=Create+AI+Singer+%28Persona%29\u0026amp;description=Train+a+custom+AI+singer+persona+from+an+existing+vocal+clip%2C+then+use+it+to+generate+music+with+a+consistent+vocal+style\u0026amp;theme=2490766786df30fa53f34c48\u0026amp;signature=4bcfc6ad62d3dc78cae96cfed995d5616fee0455628f9b9c448a38590ae7322a\">\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/zlch/hy4hiyJRP-lsZkYo/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"MusicMint - AI Music API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.musicmint.ai/api-reference/persona/create\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/persona/create.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.musicmint.ai/api-reference/persona/create\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.musicmint.ai/zh/api-reference/persona/create\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.musicmint.ai/api-reference/persona/create\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.musicmint.ai/#organization\",\"name\":\"MusicMint - AI Music API\",\"url\":\"https://docs.musicmint.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/zlch/f6feGuaFmX6fjNh7/logo/light.svg?fit=max\u0026auto=format\u0026n=f6feGuaFmX6fjNh7\u0026q=85\u0026s=e19ca3874c6820076279a42016f8b9ee\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.musicmint.ai#website\",\"name\":\"MusicMint - AI Music API\",\"url\":\"https://docs.musicmint.ai\",\"publisher\":{\"@id\":\"https://docs.musicmint.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.musicmint.ai/api-reference/persona/create#webpage\",\"url\":\"https://docs.musicmint.ai/api-reference/persona/create\",\"name\":\"Create AI Singer (Persona)\",\"description\":\"Train a custom AI singer persona from an existing vocal clip, then use it to generate music with a consistent vocal style\",\"dateModified\":\"2026-03-17T08:38:50.921Z\",\"isPartOf\":{\"@id\":\"https://docs.musicmint.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.musicmint.ai/api-reference/persona/create#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.musicmint.ai/api-reference/persona/create#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"MusicMint - AI Music API\",\"item\":\"https://docs.musicmint.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create AI Singer (Persona)\",\"item\":\"https://docs.musicmint.ai/api-reference/persona/create\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.musicmint.ai/api-reference/persona/create#article\",\"headline\":\"Create AI Singer (Persona)\",\"name\":\"Create AI Singer (Persona)\",\"description\":\"Train a custom AI singer persona from an existing vocal clip, then use it to generate music with a consistent vocal style\",\"url\":\"https://docs.musicmint.ai/api-reference/persona/create\",\"mainEntityOfPage\":{\"@id\":\"https://docs.musicmint.ai/api-reference/persona/create#webpage\"},\"dateModified\":\"2026-03-17T08:38:50.921Z\",\"publisher\":{\"@id\":\"https://docs.musicmint.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.musicmint.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"MusicMint - AI Music API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"MusicMint - AI Music API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/persona/create.md","siteName":"MusicMint - AI Music API","nav":{"global":{"anchors":[{"anchor":"API Reference","icon":"code","href":"/api-reference/introduction"}]},"languages":[{"language":"en","groups":[{"group":"Getting Started","pages":[{"title":"MusicMint - AI Music API","href":""},{"title":"Quickstart","href":"/quickstart"}]},{"group":"Overview","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Webhooks","href":"/api-reference/webhooks"},{"title":"AppKey Management","href":"/api-reference/appkey"}]},{"group":"Music Generation","pages":[{"title":"Generate Music","href":"/api-reference/music/generate"},{"title":"Cover / Remix","href":"/api-reference/music/cover"},{"title":"Remaster","href":"/api-reference/music/remaster"},{"title":"Sound Effects","href":"/api-reference/music/soundfx"},{"title":"Add Vocals (Overpainting)","href":"/api-reference/music/add-vocals"},{"title":"Infill (Replace Section)","href":"/api-reference/music/infill"},{"title":"Upload Audio","href":"/api-reference/music/upload"},{"title":"Concat","href":"/api-reference/music/concat"},{"title":"Add Instrumental","href":"/api-reference/music/add-instrumental"},{"title":"Sample / Humming","href":"/api-reference/music/sample"}]},{"group":"Lyrics","pages":[{"title":"Generate Lyrics","href":"/api-reference/lyrics/generate"}]},{"group":"Audio Processing","pages":[{"title":"Stem Separation","href":"/api-reference/audio/stem"},{"title":"MIDI Export","href":"/api-reference/audio/midi"},{"title":"Lyrics Timeline","href":"/api-reference/audio/timeline"},{"title":"Waveform Data","href":"/api-reference/audio/waveform"},{"title":"WAV Download","description":"Get a high-quality WAV download URL for a clip","href":"/api-reference/audio/wav"}]},{"group":"AI Singer (Persona)","pages":[{"title":"Create AI Singer (Persona)","href":"/api-reference/persona/create"}]},{"group":"Tasks \u0026 Results","pages":[{"title":"Get Task","description":"Poll the status and results of an async generation task","href":"/api-reference/tasks/get"},{"title":"List Tasks","href":"/api-reference/tasks/list"},{"title":"Get Music","href":"/api-reference/music/get"}]}]},{"language":"zh","pages":[{"title":"zh","href":"/zh/api-reference/persona/create"}]}]},"basePath":"","title":"Create AI Singer (Persona) - MusicMint - AI Music API","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":[],"chunks":[]}