# Suno via Locus x402 — Generate Lyrics

> Suno via Locus x402 — Generate Lyrics is a paid API for AI agents from suno.x402.paywithlocus.com, paid per call via x402, $0.025/call, status unknown (last checked 2026-09-15).

Generates AI-written song lyrics based on a text prompt describing theme, mood, style, or topic

## Facts

- Endpoint: POST https://suno.x402.paywithlocus.com/suno/generate-lyrics
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suno-via-locus-x402-generate-lyrics-fe7b3c19
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FYkLO3nSSZrEA7n-Q7a5f

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability suno-via-locus-x402-generate-lyrics-fe7b3c19 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "prompt": {
   "type": "string"
  },
  "callBackUrl": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suno-via-locus-x402-generate-lyrics-fe7b3c19/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from suno.x402.paywithlocus.com](https://www.zero.xyz/host/suno.x402.paywithlocus.com/llms.txt)