# Suno Generate Music

> Suno Generate Music is a paid API for AI agents from Suno at suno.mpp.paywithlocus.com, paid per call via MPP, $0.105000/call, status unknown (last checked 2026-10-12, last successful call 2026-08-27).

Generates a full AI music track with optional custom style, lyrics, vocals, and instrumental modes using Suno AI models

## Facts

- Endpoint: POST https://suno.mpp.paywithlocus.com/suno/generate-music?utm_source=zero.xyz
- Price: $0.105000/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-12
- Last successful call: 2026-08-27
- Success rate: 97% of calls made through Zero
- Rating: 2.7 / 5 from 20 reviews
- Activations on Zero: 960
- Provider: Suno
- Docs: https://docs.sunoapi.org
- Website: https://sunoapi.org
- Tags: music-generation, ai-music, lyrics, songs, ai, media
- Canonical page: https://www.zero.xyz/c/suno-generate-music-148a60d9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2OirThMnYdmJzDO-eBrnu

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-generate-music-148a60d9 -d '<json body>'
```

Example prompt: Use Suno to generate a pop song called 'Summer Glow' with upbeat, energetic style and female vocals — here are the lyrics: 'Verse 1: The sun is shining down on me, Chorus: Summer glow, let it flow, feel the heat.' Use model V5 and make sure it includes vocals.

## When to prefer this

Use this endpoint when you need to generate a full AI music track using Suno's state-of-the-art models, especially when you need control over style, lyrics, vocals, and instrumental settings. Prefer this over generic music APIs when you want Suno-quality output with custom mode, vocal gender selection, or negative tag filtering.

## Known failure modes

- Missing required fields (customMode, instrumental, model) returns validation error
- Style or prompt exceeds character limits (200 chars for style, 3000-5000 for prompt)
- Invalid model value returns error (must be V4, V4_5, V4_5ALL, V4_5PLUS, or V5)
- Callback URL is malformed or unreachable
- Generation task fails asynchronously — must check status via Get Music Status endpoint
- Payment failure or insufficient USDC balance

## How this service works

Submit an AI music generation task. Returns a taskId immediately — use get-music-status to poll for completion. In custom mode, you control the style, title, and prompt; in non-custom mode Suno creates everything from the prompt alone. Typical completion time: 30–120 seconds.

## Output

Returns a task ID (e.g. '76f80fead87aaf3ffd7b48137d8ba3e6') that can be used to poll the Get Music Status endpoint for the completed audio track. Success is indicated by code 200 and msg 'success'.

## Example request

```json
{
 "model": "V4",
 "style": "ambient, relaxing, calming",
 "title": "Peaceful Morning",
 "customMode": true,
 "instrumental": true
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "customMode",
  "instrumental",
  "model"
 ],
 "properties": {
  "model": {
   "type": "string",
   "description": "Model to use: V4, V4_5, V4_5ALL, V4_5PLUS, V5, or V5_5 (latest)"
  },
  "style": {
   "type": "string",
   "description": "Music style/genre tags (e.g. \"pop, upbeat, female vocals\"). Required when customMode=true. Max 200 chars."
  },
  "title": {
   "type": "string",
   "description": "Song title. Required when customMode=true. Max 80 chars."
  },
  "prompt": {
   "type": "string",
   "description": "Lyrics or description. Required when customMode=true and instrumental=false. Max 3000–5000 chars."
  },
  "customMode": {
   "type": "boolean",
   "description": "true = you control style/title/prompt; false = Suno generates everything from prompt"
  },
  "callBackUrl": {
   "type": "string",
   "description": "Webhook URL for completion notifications. Optional — a noop URL is used by default."
  },
  "vocalGender": {
   "type": "string",
   "description": "Preferred vocal gender: \"female\" or \"male\""
  },
  "instrumental": {
   "type": "boolean",
   "description": "true = no vocals (music only); false = include AI-generated vocals"
  },
  "negativeTags": {
   "type": "string",
   "description": "Styles/elements to avoid (e.g. \"heavy metal, distortion\")"
  }
 },
 "additionalProperties": true
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "data",
  "success"
 ],
 "properties": {
  "data": {
   "type": "object",
   "required": [
    "msg",
    "code",
    "data"
   ],
   "properties": {
    "msg": {
     "type": "string"
    },
    "code": {
     "type": "number"
    },
    "data": {
     "type": "object",
     "required": [
      "taskId"
     ],
     "properties": {
      "taskId": {
       "type": "string"
      }
     }
    }
   }
  },
  "success": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suno-generate-music-148a60d9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from suno.mpp.paywithlocus.com](https://www.zero.xyz/host/suno.mpp.paywithlocus.com/llms.txt)