Poll the status of a Suno AI music generation task via MPP micropayment.
What it does
The Suno — Get Music Status endpoint lets callers check the progress of an AI music generation job previously submitted to the companion `/suno/generate-music` endpoint. You POST a `taskId` (returned by the generate-music call) and receive the current status of the song creation task. The endpoint is part of a broader Suno service suite hosted on the Locus MPP gateway that also includes music generation, lyrics generation, and lyrics status polling.
Payment is handled via the MPP (Micropayment Protocol) with the Tempo settlement method. Each status poll costs 5,000 base units of pathUSD (6 decimals), which works out to $0.005 per call — essentially half a cent. The generate-music endpoint itself costs $0.105 per call, so status polling is comparatively inexpensive. The endpoint accepts POST requests with a JSON body containing a single required field (`taskId`).
The service is documented via an OpenAPI 3.1.0 spec and references external docs at sunoapi.org and docs.sunoapi.org. Note that the probe did not receive a 402 challenge when hitting this endpoint with HEAD/GET — this is expected because the endpoint only accepts POST. The underlying Suno models supported include V4, V4_5, V4_5ALL, V4_5PLUS, and V5.
Capabilities
Use cases
- —Polling whether a Suno AI-generated song is complete and ready for download
- —Building an async workflow that submits music generation jobs and periodically checks completion
- —Integrating Suno music generation into an agent pipeline that needs to wait for results
Fit
Best for
- —Agents or apps that have already called /suno/generate-music and need to check task completion
- —Async music generation workflows requiring status polling
- —Low-cost per-call status checks at $0.005 each
Not for
- —Generating music directly — use the companion /suno/generate-music endpoint instead
- —Streaming real-time audio — this is a status polling endpoint, not a media stream
Quick start
curl -X POST https://suno.mpp.paywithlocus.com/suno/get-music-status \
-H "Content-Type: application/json" \
-d '{"taskId": "your-task-id-here"}'Example
Request
{
"taskId": "abc123-def456-ghi789"
}Endpoint
Quality
OpenAPI schema is complete for the request side, but no response schema or example response is provided. The probe did not capture a 402 challenge (expected since the endpoint is POST-only and was probed with HEAD/GET). No crawled documentation was available — all crawled pages returned 404. Price is clear from the spec.
Warnings
- —No response schema documented — the shape of a successful 200 response is unknown.
- —Probe did not capture a 402 MPP challenge because HEAD/GET were used on a POST-only endpoint; liveness via POST is not confirmed.
- —All crawled pages (root, /docs, /api, /pricing, /README) returned 404 with a redirect to skill.md/llms.txt — no supplementary documentation was retrieved.
- —External docs at sunoapi.org and docs.sunoapi.org were not crawled; claims about response format cannot be verified.
Citations
- —The endpoint costs 5000 base units of pathUSD per call ($0.005)https://suno.mpp.paywithlocus.com
- —The endpoint accepts POST with a required taskId fieldhttps://suno.mpp.paywithlocus.com
- —Supported Suno models include V4, V4_5, V4_5ALL, V4_5PLUS, and V5https://suno.mpp.paywithlocus.com
- —External documentation is referenced at sunoapi.org and docs.sunoapi.orghttps://suno.mpp.paywithlocus.com