# WithZero Lyria 3 Pro Song Generator

> WithZero Lyria 3 Pro Song Generator is a paid API for AI agents from agents.withzero.xyz, paid per call via x402 or MPP, $0.08/call, status unknown (last checked 2026-10-09, last successful call 2026-07-31).

Generates a full AI-composed song from a text prompt using the Lyria 3 Pro model, billed per call via ZeroClick's pay-per-use proxy.

## Facts

- Endpoint: POST https://agents.withzero.xyz/api/v1/audio/songs/lyria-3-pro?utm_source=zero.xyz
- Price: $0.08/call
- Payment: x402, MPP
- Status: unknown
- Last checked: 2026-10-09
- Last successful call: 2026-07-31
- Success rate: 33% of calls made through Zero
- Rating: 2.3 / 5 from 1 review
- Activations on Zero: 3
- Tags: x402
- Canonical page: https://www.zero.xyz/c/withzero-lyria-3-pro-song-generator-7446399a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YZ-uNvxLNByN9vct2n1qM

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 withzero-lyria-3-pro-song-generator-7446399a -d '<json body>'
```

Example prompt: Can you generate a full song for me? I want something like an upbeat electronic dance track with driving synths and an energetic build-up — use seed 42 so I can reproduce it later.

## When to prefer this

Choose this endpoint when you need on-demand AI music generation without setting up vendor accounts or API keys — ideal for agents autonomously creating audio content, producing background music, or generating songs as part of a larger automated workflow, billed transparently per call at $0.08 USDC.

## Known failure modes

- Prompt too short (minLength 1) or too long (maxLength 4000) returns validation error
- Seed value outside integer range causes rejection
- Payment failure via x402 micropayment protocol blocks the request
- Model generation timeout for complex prompts
- Non-deterministic output even with same seed (seed is best-effort only)

## How this service works

Generate one to three complete songs with Google's Lyria 3 Pro, optionally translate vocal functions into instruments, master the audio, rank candidates with local DSP, and return hosted audio URLs.

## Output

Returns a generated audio song file (or URL/binary) produced by the Lyria 3 Pro model matching the text prompt description, optionally reproducible with the provided seed value.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "example": {
  "prompt": "A short upbeat synthwave instrumental with a driving bassline"
 },
 "required": [
  "prompt",
  "candidateCount"
 ],
 "properties": {
  "seed": {
   "type": "integer",
   "maximum": 9007199254740991,
   "minimum": -9007199254740991,
   "description": "Seed for repeatable generation (best effort)."
  },
  "topP": {
   "type": "number",
   "maximum": 1,
   "minimum": 0,
   "description": "OpenRouter nucleus-sampling probability from 0 to 1."
  },
  "prompt": {
   "type": "string",
   "maxLength": 4000,
   "minLength": 1,
   "description": "Text description of the song to generate (1–4000 characters)."
  },
  "sections": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "startSec",
     "endSec",
     "name",
     "description"
    ],
    "properties": {
     "name": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Section label, for example Intro, Verse, Chorus, or Bridge."
     },
     "endSec": {
      "type": "integer",
      "maximum": 300,
      "minimum": 1,
      "description": "Exclusive section end in whole seconds."
     },
     "startSec": {
      "type": "integer",
      "maximum": 300,
      "minimum": 0,
      "description": "Inclusive section start in whole seconds."
     },
     "intensity": {
      "type": "integer",
      "maximum": 10,
      "minimum": 1,
      "description": "Target section intensity from 1 (minimal) to 10 (maximum)."
     },
     "description": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "Instrumentation, melody, rhythm, and production instructions for this section."
     }
    },
    "additionalProperties": false
   },
   "maxItems": 20,
   "description": "Up to 20 ordered, non-overlapping arrangement sections converted to Lyria timestamp directives."
  },
  "mastering": {
   "type": "object",
   "required": [
    "targetLufs",
    "truePeakDb",
    "fadeOutSec"
   ],
   "properties": {
    "fadeOutSec": {
     "type": "number",
     "default": 1,
     "maximum": 10,
     "minimum": 0,
     "description": "Final fade duration in seconds."
    },
    "targetLufs": {
     "type": "number",
     "default": -14,
     "maximum": -8,
     "minimum": -24,
     "description": "Target integrated loudness in LUFS."
    },
    "truePeakDb": {
     "type": "number",
     "default": -1,
     "maximum": -0
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "url",
  "mimeType",
  "sizeBytes",
  "seconds",
  "model",
  "price_usdc"
 ],
 "properties": {
  "url": {
   "type": "string",
   "description": "Hosted URL of the generated song (MP3)."
  },
  "model": {
   "type": "string",
   "description": "The model that produced the song."
  },
  "seconds": {
   "type": "number",
   "description": "Approximate duration of the song in seconds."
  },
  "mimeType": {
   "type": "string",
   "description": "Content type of the generated audio."
  },
  "sizeBytes": {
   "type": "number",
   "description": "Size of the generated audio in bytes."
  },
  "candidates": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "index",
     "url",
     "sizeBytes",
     "seconds",
     "score",
     "diagnostics"
    ],
    "properties": {
     "url": {
      "type": "string"
     },
     "seed": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991
     },
     "index": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
     },
     "score": {
      "type": "object",
      "required": [
       "overall",
       "duration",
       "groove",
       "structure",
       "production"
      ],
      "properties": {
       "groove": {
        "anyOf": [
         {
          "type": "number",
          "maximum": 1,
          "minimum": 0
         },
         {
          "type": "null"
         }
        ]
       },
       "overall": {
        "type": "number",
        "maximum": 1,
        "minimum": 0
       },
       "duration": {
        "type": "number",
        "maximum": 1,
        "minimum": 0
       },
       "structure": {
        "anyOf": [
         {
          "type": "number",
          "maximum": 1,
          "minimum": 0
         },
         {
          "type": "null"
         }
        ]
       },
       "production": {
        "type": "number",
        "maximum": 1,
        "minimum": 0
       }
      },
      "additionalProperties": false
     },
     "seconds": {
      "type": "number",
      "exclusiveMinimum": 0
     },
     "sizeBytes": {
      "type": "integer",
      "maximum": 9007199254740991,
      "exclusiveMinimum": 0
     },
     "diagnostics": {
      "type": "object",
      "required": [
       "durationSec",
       "tempo",
       "brightness",
       "energy",
       "sections",
       "cues"
      ],
      "
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/withzero-lyria-3-pro-song-generator-7446399a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.withzero.xyz](https://www.zero.xyz/host/agents.withzero.xyz/llms.txt)