{"uid":"cap_FYkLO3nSSZrEA7n-Q7a5f","slug":"suno-via-locus-x402-generate-lyrics-fe7b3c19","name":"Suno via Locus x402 — Generate Lyrics","description":"AI music generation — create full songs, generate lyrics, and build custom music tracks with state-of-the-art AI models. Supports custom styles, vocals, and instrumental modes.","url":"https://suno.x402.paywithlocus.com/suno/generate-lyrics","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"prompt":{"type":"string"},"callBackUrl":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{},"payment":{"scheme":"exact","settledUsdc":"0.001000","authorizedMaxUsdc":"0.001000"},"request":{"id":"00000000-0000-4000-8000-000000000000","statusUrl":"/requests/00000000-0000-4000-8000-000000000000"},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_RvKeRQDor15CAewz3zICP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates AI-written song lyrics based on a text prompt describing theme, mood, style, or topic","exampleAgentPrompt":"Write me song lyrics about a late-night city drive, melancholy mood with a hint of nostalgia — something that would fit an indie pop style.","exampleUseCases":[{"title":"Indie pop breakup song lyrics","prompt":"Write me lyrics for an indie pop breakup song — theme should be about letting go of someone you still love, bittersweet and reflective in tone."},{"title":"Motivational hip-hop anthem","prompt":"Generate rap lyrics about grinding through hard times and coming out stronger — high-energy, motivational, with a gritty urban feel, max 200 characters of description."},{"title":"Upbeat summer jingle for brand","prompt":"Create lyrics for a fun, upbeat summer song to use in a promotional video — beachy, cheerful, and catchy, something that evokes sunsets and good vibes."}],"resultDescription":"Returns a request object with a unique request ID and a status URL to poll for the completed lyrics, along with payment settlement details (amount in USDC charged). The actual lyrics are delivered asynchronously to the provided callBackUrl webhook or retrievable via the status URL.","failureModes":["Prompt exceeds 200 characters — request rejected with validation error","Invalid or unreachable callBackUrl — webhook delivery fails silently","Payment insufficient — x402 payment not accepted, request not processed","Model unavailability — Suno backend temporarily unavailable, retry needed","Ambiguous or empty prompt — low-quality or unexpected lyric output"],"whenToPreferThis":"Choose this endpoint when you need AI-generated song lyrics specifically, driven by a natural language description of theme, mood, or style. It is the right choice when you want lyrics only (not full audio) and need pay-per-use microtransaction billing via x402/USDC. Prefer it over full-song generation endpoints when you only need the text component and want lower cost per call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:35:25.064Z","isFirstParty":false}