{"uid":"cap_X0g8CtAmUOEPPwJKUUbau","slug":"suno-get-music-status-97b3ca48","name":"Suno Get Music Status","description":"Poll the status of a music generation task. Call repeatedly until status is SUCCESS (or a failed state). On SUCCESS, response includes audioUrl and imageUrl for each generated track. Status values: PENDING, TEXT_SUCCESS, FIRST_SUCCESS, SUCCESS, CREATE_TASK_FAILED, GENERATE_AUDIO_FAILED, SENSITIVE_WORD_ERROR.","url":"https://suno.mpp.paywithlocus.com/suno/get-music-status?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["taskId"],"properties":{"taskId":{"type":"string","description":"Task ID returned by generate-music"}},"additionalProperties":true},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["music-generation","ai-music","lyrics","songs","ai","media"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":10,"rating":{"score":"1.00","successRate":"0.99","reviews":10,"stars":"5.0","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Vn2Shzzxna8BsvgS4xMbD","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x20c000000000000000000000b9537d11c60e8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"Suno","brandSlug":"suno","brandBaseUrl":"https://sunoapi.org","brandDocsUrl":"https://docs.sunoapi.org","whatItDoes":"Polls the status of a previously submitted AI music generation task using its task ID","exampleAgentPrompt":"Check the status of my Suno music generation task with ID 'abc123def456' and let me know if the song is ready yet.","exampleUseCases":null,"resultDescription":"Returns the current status of the music generation task, including whether it is complete, in progress, or failed, along with the generated audio file URL or track details once the task is finished.","failureModes":["Invalid or unknown taskId returns a not-found or error status","Task still processing returns an in-progress status with no audio output yet","Network timeout if the Suno API is slow to respond","Expired taskId if the task is too old returns an error","Missing required taskId field returns a validation error"],"whenToPreferThis":"Use this endpoint after calling the Generate Music endpoint to retrieve the result. This is the correct polling endpoint for checking whether a Suno AI music generation task has completed and to obtain the final audio output. Prefer this over Generate Music when you already have a taskId and just need to check progress or retrieve results.","instructions":null,"reviewSummary":"Get Music Status delivers consistent, accurate polling for Suno music generation tasks, returning full metadata including MP3 URLs, stream URLs, lyrics, tags, duration, and candidate IDs once generation completes. All 10 reviews report successful outcomes with perfect accuracy and reliability scores, sub-4-second latency, and a low cost of $0.005 per call. No failures or edge-case issues are documented across the review set.","reviewSummaryHighlights":["Returns comprehensive song metadata: audio URLs, stream URLs, lyrics, title, tags, and duration","Sub-4-second polling latency at $0.005 per call","100% success rate across all reviewed calls with no documented failures"],"reviewSummaryConcerns":[],"reviewSummaryGeneratedAt":"2026-08-07T01:07:19.248Z","activationCount":1634,"lastUsedAt":"2026-08-27T22:17:56.177Z","lastSuccessfullyRanAt":"2026-08-27T22:17:56.177Z","lastHealthCheckAt":"2026-10-09T18:41:59.971Z","isFirstParty":false,"canonicalSlug":"suno-get-music-status-97b3ca48"}