{"uid":"cap_2OirThMnYdmJzDO-eBrnu","slug":"suno-generate-music-148a60d9","name":"Suno Generate Music","description":"Submit an AI music generation task. Returns a taskId immediately — use get-music-status to poll for completion. In custom mode, you control the style, title, and prompt; in non-custom mode Suno creates everything from the prompt alone. Typical completion time: 30–120 seconds.","url":"https://suno.mpp.paywithlocus.com/suno/generate-music?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["customMode","instrumental","model"],"properties":{"model":{"type":"string","description":"Model to use: V4, V4_5, V4_5ALL, V4_5PLUS, V5, or V5_5 (latest)"},"style":{"type":"string","description":"Music style/genre tags (e.g. \"pop, upbeat, female vocals\"). Required when customMode=true. Max 200 chars."},"title":{"type":"string","description":"Song title. Required when customMode=true. Max 80 chars."},"prompt":{"type":"string","description":"Lyrics or description. Required when customMode=true and instrumental=false. Max 3000–5000 chars."},"customMode":{"type":"boolean","description":"true = you control style/title/prompt; false = Suno generates everything from prompt"},"callBackUrl":{"type":"string","description":"Webhook URL for completion notifications. Optional — a noop URL is used by default."},"vocalGender":{"type":"string","description":"Preferred vocal gender: \"female\" or \"male\""},"instrumental":{"type":"boolean","description":"true = no vocals (music only); false = include AI-generated vocals"},"negativeTags":{"type":"string","description":"Styles/elements to avoid (e.g. \"heavy metal, distortion\")"}},"additionalProperties":true},"responseSchema":{"type":"object","required":["data","success"],"properties":{"data":{"type":"object","required":["msg","code","data"],"properties":{"msg":{"type":"string"},"code":{"type":"number"},"data":{"type":"object","required":["taskId"],"properties":{"taskId":{"type":"string"}}}}},"success":{"type":"boolean"}}},"example":{"request":{"model":"V4","style":"ambient, relaxing, calming","title":"Peaceful Morning","customMode":true,"instrumental":true},"response":{"data":{"msg":"success","code":200,"data":{"taskId":"12f8b20a9c640881a06260d15b58b8e8"}},"success":true}},"exampleRequest":{"model":"V4","style":"ambient, relaxing, calming","title":"Peaceful Morning","customMode":true,"instrumental":true},"tags":["music-generation","ai-music","lyrics","songs","ai","media"],"displayCostAmount":"0.105000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":20,"rating":{"score":"0.42","successRate":"0.97","reviews":20,"stars":"2.7","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.105000/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.105","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.105","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CBhF_oKDXlCiQe9fckozi","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.105","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"Suno","brandSlug":"suno","brandBaseUrl":"https://sunoapi.org","brandDocsUrl":"https://docs.sunoapi.org","whatItDoes":"Generates a full AI music track with optional custom style, lyrics, vocals, and instrumental modes using Suno AI models","exampleAgentPrompt":"Use Suno to generate a pop song called 'Summer Glow' with upbeat, energetic style and female vocals — here are the lyrics: 'Verse 1: The sun is shining down on me, Chorus: Summer glow, let it flow, feel the heat.' Use model V5 and make sure it includes vocals.","exampleUseCases":[{"title":"Create branded podcast intro music","prompt":"I need you to generate a short instrumental intro track for my podcast using Suno. Make it professional and energetic, around 30 seconds, with a modern electronic style. No vocals needed — just a catchy instrumental that will loop well."},{"title":"Write custom jingle for ad campaign","prompt":"Can you use Suno to create an upbeat 15-second jingle for my coffee brand? I want it to be memorable and fun with a female voice singing these lyrics: 'Wake up to something great, morning starts with us today.' Keep it pop-style and cheerful."},{"title":"Produce ambient background music","prompt":"Generate some calm, ambient background music using Suno that's about 2 minutes long. Make it instrumental without any vocals, with a relaxing lo-fi vibe that would work well for a meditation app or study sessions."}],"resultDescription":"Returns a task ID (e.g. '76f80fead87aaf3ffd7b48137d8ba3e6') that can be used to poll the Get Music Status endpoint for the completed audio track. Success is indicated by code 200 and msg 'success'.","failureModes":["Missing required fields (customMode, instrumental, model) returns validation error","Style or prompt exceeds character limits (200 chars for style, 3000-5000 for prompt)","Invalid model value returns error (must be V4, V4_5, V4_5ALL, V4_5PLUS, or V5)","Callback URL is malformed or unreachable","Generation task fails asynchronously — must check status via Get Music Status endpoint","Payment failure or insufficient USDC balance"],"whenToPreferThis":"Use this endpoint when you need to generate a full AI music track using Suno's state-of-the-art models, especially when you need control over style, lyrics, vocals, and instrumental settings. Prefer this over generic music APIs when you want Suno-quality output with custom mode, vocal gender selection, or negative tag filtering.","instructions":null,"reviewSummary":"When operational, this Suno-backed music generation service reliably produces two audio tracks per call (MP3, typically 30–120s end-to-end) with strong style-prompt adherence across genres—from G-funk to children's singalongs to electronic dance-pop. However, roughly half of reviewed calls result in upstream Suno credit exhaustion (HTTP 429), where the $0.105 charge goes through but no taskId or audio is returned; the service incorrectly reports as 'healthy' during these outages. A separate max_pay_exceeded issue also blocks calls entirely when per-call spend caps are set below $0.105.","reviewSummaryHighlights":["Accurately matches detailed style prompts across diverse genres (pop, hip-hop, electronic, cinematic)","Returns two MP3 track variants per successful call, typically within 90–120 seconds","Custom mode supports lyrics, title, and style tags with reliable vocal rendering"],"reviewSummaryConcerns":["Frequent upstream Suno credit exhaustion (429 errors) charges $0.105 per failed call with no refund or taskId","Service reports 'healthy' status even during extended outage periods spanning multiple days","Effective minimum cost of $0.105/call makes advertised lower pricing unreachable due to payment threshold constraints"],"reviewSummaryGeneratedAt":"2026-08-18T00:15:09.017Z","activationCount":960,"lastUsedAt":"2026-10-07T16:50:33.225Z","lastSuccessfullyRanAt":"2026-08-27T22:16:45.266Z","lastHealthCheckAt":"2026-10-12T17:35:03.088Z","isFirstParty":false,"canonicalSlug":"suno-generate-music-148a60d9"}