# Suede AI Music Generator

> Suede AI Music Generator is a paid API for AI agents from app.suedeai.ai, paid per call via x402, $0.5/call, status healthy (last checked 2026-10-09).

Generates a full-length, fully owned song from a text prompt with optional custom lyrics, style control, vocal gender, and IP registration.

## Facts

- Endpoint: POST https://app.suedeai.ai/create-music?utm_source=zero.xyz
- Price: $0.5/call
- Payment: x402
- Status: healthy
- Last checked: 2026-10-09
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suede-ai-music-generator-8aeae7bd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vJJiOv6mrLpUAKj6JNr4R

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-ai-music-generator-8aeae7bd -d '<json body>'
```

Example prompt: Create a full-length upbeat 80s synthwave song with a female vocalist about driving through a neon city at night — use custom lyrics: 'Neon lights are burning bright, racing through the endless night' — and tag it as 'synthwave, retro, driving'.

## When to prefer this

Choose this endpoint when the user needs a complete, multi-minute original song they fully own the rights to — not a short clip or preview. Ideal when custom lyrics, genre control, vocal gender selection, or IP registration and licensing are required. Prefer over generic AI music tools when provenance, ownership fingerprint, or programmable licensing is important.

## Known failure modes

- Missing required prompt field returns a 400 validation error
- custom_mode set to true but lyrics field is empty or missing causes a generation failure
- Invalid vocal_gender enum value (not 'm' or 'f') returns a 422 unprocessable entity
- Payment not completed or insufficient USDC balance returns a 402 Payment Required
- Generation timeout or model overload returns a 503 or 504 error
- Prompt too vague or violating content policy may return a 400 or 403 with a policy message

## How this service works

AI music generation from a text prompt. Creates a complete original song with vocals, melody, and full arrangement as a finished MP3, not a loop or preview. Describe genre, mood, instrumentation, and tempo, supply your own lyrics, request an instrumental, or pin a style tag. Use for soundtracks under video, release-ready artist tracks, podcast and game themes, and demo sketches. Async: poll songId until model_version leaves 'pending'.

## Output

Returns a track ID, a CDN URL to the full MP3 audio file, a shareable link to the track page, and a provenance fingerprint registering ownership in the IP and licensing workflow.

## 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
{
 "shareUrl": "https://app.suedeai.ai/share/example-track"
}
```

## More

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