AI music generation via Suno — create songs, lyrics, and instrumentals, pay-per-call over MPP/Tempo.
What it does
This endpoint exposes Suno's AI music generation capabilities through the Locus MPP (Micropayment Protocol), settling payments in pathUSD on Tempo L2. It provides four operations: generate full music tracks, check music generation status, generate lyrics from a text prompt, and check lyrics generation status. The generate-music endpoint is the primary call listed here.
The generate-music endpoint accepts a JSON body specifying the Suno model version (V4, V4_5, V4_5ALL, V4_5PLUS, or V5), whether to use custom mode (where you supply style, title, and prompt) or let Suno auto-generate from a description, and whether the output should be instrumental-only or include AI vocals. Additional options include negative style tags, vocal gender preference, and a webhook callback URL for async completion notifications. The endpoint is POST-only and returns a task ID; you then poll the companion /suno/get-music-status endpoint to retrieve the finished audio.
Pricing is per-call in pathUSD on Tempo L2. Music generation costs 105,000 base units ($0.105), lyrics generation costs 25,000 base units ($0.025), and status-check calls cost 5,000 base units ($0.005). The currency address is 0x20c000000000000000000000b9537d11c60e8b50 (pathUSD, 6 decimals). Note that the endpoint returned 404 on HEAD/GET probes — it is a POST-only endpoint, so the 404 does not necessarily indicate the service is down, but a live 402 challenge was not directly captured during probing.
Capabilities
Use cases
- —Generate full AI songs with vocals from a text prompt or custom lyrics
- —Create instrumental background music for videos, podcasts, or games
- —Auto-generate song lyrics from a theme or mood description
- —Build music-generation features into apps without managing Suno accounts
- —Prototype musical ideas quickly using different Suno model versions
Fit
Best for
- —Developers adding AI music generation to products via a simple REST call
- —Agents or workflows that need on-demand audio content creation
- —Projects requiring pay-per-use pricing without subscriptions
Not for
- —Real-time streaming audio synthesis (this is async task-based)
- —Editing or remixing existing audio files
- —Free or bulk music generation without per-call costs
Quick start
curl -X POST https://suno.mpp.paywithlocus.com/suno/generate-music \
-H "Content-Type: application/json" \
-H "Authorization: <MPP-Tempo-Payment-Header>" \
-d '{
"customMode": false,
"instrumental": false,
"model": "V5",
"prompt": "An upbeat pop song about a sunny day at the beach"
}'Example
Request
{
"model": "V5",
"style": "pop, upbeat, female vocals",
"title": "Sunny Day",
"prompt": "[Verse]\nWalking down the shore, sand between my toes\n[Chorus]\nSunshine on my face, everywhere I go",
"customMode": true,
"vocalGender": "female",
"instrumental": false,
"negativeTags": "heavy metal, distortion"
}Response
{
"taskId": "abc123-def456-ghi789",
"success": true
}Endpoint
Quality
Full OpenAPI schema with detailed request body, four endpoints, and clear pricing is available. However, no live 402 challenge was captured (POST-only endpoint probed with HEAD/GET), no response schema is documented, and crawl pages all returned 404 with generic error messages. The example response is inferred, not sourced.
Warnings
- —No live 402 MPP challenge was captured — the endpoint is POST-only and probes used HEAD/GET, so liveness is not confirmed but not disproven.
- —Response schema for 200 is undocumented; the example response is inferred from typical async-task patterns.
- —The currency address 0x20c000000000000000000000b9537d11c60e8b50 is assumed to be pathUSD with 6 decimals based on the Tempo method context; this is not explicitly confirmed in the probe.
- —No crawled documentation was retrievable; all auxiliary pages returned 404.
Citations
- —OpenAPI spec lists four endpoints: generate-music, get-music-status, generate-lyrics, get-lyrics-statushttps://suno.mpp.paywithlocus.com
- —Generate-music costs 105000 base units, generate-lyrics costs 25000, status checks cost 5000, all in pathUSD via Tempohttps://suno.mpp.paywithlocus.com
- —Supported models include V4, V4_5, V4_5ALL, V4_5PLUS, and V5https://suno.mpp.paywithlocus.com
- —API reference docs referenced at https://docs.sunoapi.org and LLM skill file at https://beta.paywithlocus.com/mpp/suno.mdhttps://suno.mpp.paywithlocus.com