# Suede Labs AI Music Generator

> Suede Labs AI Music Generator is a paid API for AI agents from app.suedeai.xyz, paid per call via x402, $0.2/call, status unknown (last checked 2026-09-15).

Generates unique AI-composed music tracks with optional custom lyrics, vocal gender selection, and genre/style control, recorded on the blockchain

## Facts

- Endpoint: POST https://app.suedeai.xyz/create-music
- Price: $0.2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suede-labs-ai-music-generator-4a03a85a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wdSi3YEoX5Dx0sfiaAaz0

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 suede-labs-ai-music-generator-4a03a85a -d '<json body>'
```

Example prompt: Can you create an upbeat 80s synthwave track with driving bass and neon atmosphere using Suede Labs — make it instrumental, no vocals, and tag it as 'retro, electronic, energetic'?

## When to prefer this

Use this endpoint when you need to generate an original AI-composed music track, especially when blockchain provenance of the audio asset is important, or when you want granular control over genre, lyrics, vocal gender, and instrumental vs. vocal output. Prefer this over generic audio APIs when the user wants a fully composed song rather than audio effects or speech synthesis.

## Known failure modes

- Missing prompt when custom_mode is false — returns validation error
- lyrics field empty when custom_mode is true — returns error requiring lyrics
- Invalid vocal_gender value outside 'm'/'f' enum — schema validation error
- Insufficient USDC balance or payment failure — 402 payment required error
- Conflicting make_instrumental:true with lyrics/vocal_gender fields — may produce unexpected output or error
- Service unavailable or AI generation timeout — 5xx error

## How this service works

Create unique music tracks on the blockchain using our artificial intelligence agents

## Output

A JSON response containing details about the newly generated AI music track, including a reference or link to the blockchain-recorded audio file.

## Example request

```json
{
 "tags": "synthwave,80s,electronic,neon,upbeat",
 "style": "Synthwave",
 "prompt": "Upbeat synthwave track with neon atmosphere and driving synthesizer bass",
 "vocal_gender": "m",
 "make_instrumental": true
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tags": {
   "type": "string",
   "description": "Comma-separated keywords to tag the generated file."
  },
  "style": {
   "type": "string",
   "description": "Specific musical style or genre tag (e.g., 'Hip Hop', 'Ambient', 'Rock'). Helping the AI focus on a specific sound."
  },
  "lyrics": {
   "type": "string",
   "description": "Your custom lyrics. Required if custom_mode is true."
  },
  "prompt": {
   "type": "string",
   "description": "Describe the song you want to create. Include genre, mood, instruments, and any specific vibe. Example: 'Upbeat 80s synthwave with driving bass and neon atmosphere' or 'A melancholic acoustic guitar ballad about rain'."
  },
  "custom_mode": {
   "type": "boolean",
   "description": "Set to true to use your own lyrics provided in the 'lyrics' field."
  },
  "vocal_gender": {
   "enum": [
    "m",
    "f"
   ],
   "type": "string",
   "description": "Preferred gender for the vocalist ('m' for male, 'f' for female)."
  },
  "make_instrumental": {
   "type": "boolean",
   "description": "If true, generates a track without vocals."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suede-labs-ai-music-generator-4a03a85a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from app.suedeai.xyz](https://www.zero.xyz/host/app.suedeai.xyz/llms.txt)