Generate song lyrics from a text prompt via Suno AI, paid per call with pathUSD on Tempo L2.
What it does
This MPP endpoint wraps Suno's AI lyrics generation capability behind a micropayment paywall served by Locus. You send a short text prompt describing the desired theme, mood, style, or topic (up to 200 characters), and the service returns AI-generated lyrics. The workflow is asynchronous: the generate-lyrics call returns a task ID, and you poll a companion endpoint (/suno/get-lyrics-status) to retrieve the finished lyrics once processing completes. An optional webhook callback URL can be supplied instead of polling.
The endpoint is part of a broader Suno service suite hosted at suno.mpp.paywithlocus.com that also offers full music generation (with models V4 through V5), music status polling, and lyrics status polling. Payment is settled per-call via the Tempo L2 method using pathUSD (6 decimals). The generate-lyrics call costs 25,000 base units, which equals $0.025 per request. The lyrics-status polling endpoint costs 5,000 base units ($0.005). No API key or subscription is required; the 402 payment challenge is the sole authentication mechanism.
Note that the probe did not receive a 402 challenge on HEAD/GET for this endpoint — the OpenAPI spec indicates the endpoint accepts POST requests, so the 404 on HEAD/GET is expected routing behavior, not an outage. The OpenAPI schema is well-defined with clear request parameters and payment metadata.
Capabilities
Use cases
- —Generating draft song lyrics from a theme or mood description
- —Feeding AI-generated lyrics into a downstream music generation pipeline
- —Prototyping song ideas by iterating on lyric prompts
- —Building a creative writing tool that includes lyric composition
Fit
Best for
- —Agents or apps that need on-demand lyric drafts without a subscription
- —Workflows combining lyrics generation with Suno music generation endpoints
- —Developers who want pay-per-call pricing with no API key management
Not for
- —High-volume batch lyric generation where subscription pricing would be cheaper
- —Use cases requiring real-time streaming lyrics (this is async/polling-based)
- —Users who need fine-grained control over verse structure or rhyme scheme beyond a 200-char prompt
Quick start
curl -X POST https://suno.mpp.paywithlocus.com/suno/generate-lyrics \
-H "Content-Type: application/json" \
-d '{"prompt": "A hopeful pop song about starting over after heartbreak"}'Example
Request
{
"prompt": "A hopeful pop song about starting over after heartbreak",
"callBackUrl": "https://example.com/webhook/lyrics-done"
}Endpoint
Quality
The OpenAPI spec is complete with request schemas, payment metadata, and endpoint descriptions. However, the probe did not capture a live 402 challenge (POST was not attempted), no response schema or example response is documented, and the crawled pages all returned 404 with no additional documentation. Pricing and request format are clear from the spec but response structure must be inferred.
Warnings
- —Probe used HEAD/GET which returned 404; the endpoint is POST-only so liveness could not be confirmed via the probe.
- —No response schema is documented — the shape of the generated lyrics payload is unknown.
- —No example responses are available from the crawl or OpenAPI spec.
- —External docs at sunoapi.org and docs.sunoapi.org were not crawled; additional detail may exist there.
Citations
- —The generate-lyrics endpoint costs 25,000 base units of pathUSD (6 decimals = $0.025) per call, settled via Tempo L2.https://suno.mpp.paywithlocus.com
- —The prompt field accepts up to 200 characters describing desired lyrics theme, mood, style, or topic.https://suno.mpp.paywithlocus.com
- —The service is part of a Suno suite that also includes generate-music, get-music-status, and get-lyrics-status endpoints.https://suno.mpp.paywithlocus.com
- —Supported music generation models include V4, V4_5, V4_5ALL, V4_5PLUS, and V5.https://suno.mpp.paywithlocus.com
- —External documentation is referenced at https://sunoapi.org and https://docs.sunoapi.org.https://suno.mpp.paywithlocus.com