Poll the status of an AI lyrics generation task on Suno via MPP micropayment.
What it does
The Suno Get Lyrics Status endpoint lets you check the progress and retrieve results of a lyrics generation task previously submitted to the Suno Generate Lyrics endpoint. It is part of a broader Suno AI music generation service exposed through the Locus MPP (Micropayment Protocol) gateway, which settles payments per-call on the Tempo L2 network using pathUSD.
To use this endpoint, you POST a JSON body containing the `taskId` returned by the `/suno/generate-lyrics` call. The endpoint charges $0.005 per request (5,000 base units of pathUSD with 6 decimals). The companion generate-lyrics endpoint costs $0.025 per call, and the full music generation endpoint costs $0.105 per call. All endpoints use the same charge-per-call (intent: charge) settlement model via the Tempo method.
Note that the probe returned 404 on HEAD and GET requests, which is expected because this endpoint only accepts POST. The OpenAPI spec clearly defines it as a POST endpoint with a well-documented request schema. The service references external documentation at sunoapi.org and docs.sunoapi.org, as well as a Locus-hosted skill file at beta.paywithlocus.com/mpp/suno.md. No response schema is documented, so the exact shape of the status response must be inferred or discovered at runtime.
Capabilities
Use cases
- —Polling for completion of an AI-generated lyrics task before rendering results to a user
- —Building an async lyrics generation pipeline that submits a prompt and periodically checks status
- —Integrating Suno lyrics generation into a chatbot or agent workflow with status tracking
- —Monitoring lyrics task progress in a music production automation tool
Fit
Best for
- —Agents or apps that need to poll async lyrics generation tasks
- —Developers building AI-powered songwriting tools
- —Micropayment-native workflows that pay per API call without subscriptions
Not for
- —Generating lyrics directly — use the /suno/generate-lyrics endpoint for that
- —Generating full music tracks — use /suno/generate-music instead
- —Use cases requiring subscription-based or free-tier access
Quick start
curl -X POST https://suno.mpp.paywithlocus.com/suno/get-lyrics-status \
-H "Content-Type: application/json" \
-d '{"taskId": "your-task-id-here"}'Example
Request
{
"taskId": "abc123-def456-ghi789"
}Endpoint
Quality
The OpenAPI spec provides a clear request schema, pricing, and endpoint metadata. However, no response schema is documented, the probe returned 404 because it only tried HEAD/GET on a POST-only endpoint, and crawled pages yielded no additional documentation. The endpoint is likely live but unconfirmed via probe.
Warnings
- —Probe returned 404 on HEAD and GET — endpoint is POST-only; liveness not directly confirmed by probe
- —No response schema documented in the OpenAPI spec; response shape is unknown
- —External docs (sunoapi.org, docs.sunoapi.org) were not crawled and may contain additional details
- —Currency address 0x20c000000000000000000000b9537d11c60e8b50 assumed to be pathUSD with 6 decimals based on Tempo L2 convention
Citations
- —Endpoint charges 5000 base units via Tempo method with intent 'charge'https://suno.mpp.paywithlocus.com
- —Request body requires a taskId string returned by generate-lyricshttps://suno.mpp.paywithlocus.com
- —Service documentation references sunoapi.org and docs.sunoapi.orghttps://suno.mpp.paywithlocus.com
- —OpenAPI spec describes the endpoint as POST with summary 'Get Lyrics Status'https://suno.mpp.paywithlocus.com