Skip to content
onelayer.
All tools

Tool detail

Suede AI

Generates a complete original song (MP3) with vocals and arrangement from a text prompt, or an instrumental.

Categories: Image generation, Speech audio

Use when

  • generate a full song with vocals from a text description
  • generate an instrumental soundtrack for a video
  • generate a song using custom lyrics

Not for

  • not a short loop or preview - produces a finished track
  • not synchronous - poll songId until ready

Inputs

POST JSON body: { prompt: string (required) }; optional: custom_mode, lyrics (if custom_mode), make_instrumental, style, tags, vocal_gender (m/f)

Admitted input schema

{
  "type": "object",
  "properties": {
    "custom_mode": {
      "type": "boolean",
      "description": "Set to true to use your own lyrics provided in the 'lyrics' field."
    },
    "lyrics": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Your custom lyrics. Required if custom_mode is true."
    },
    "make_instrumental": {
      "type": "boolean",
      "description": "If true, generates a track without vocals."
    },
    "prompt": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "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'."
    },
    "style": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Specific musical style or genre tag (e.g., 'Hip Hop', 'Ambient', 'Rock'). Helping the AI focus on a specific sound."
    },
    "tags": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Comma-separated keywords to tag the generated file."
    },
    "vocal_gender": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "m",
        "f"
      ],
      "description": "Preferred gender for the vocalist ('m' for male, 'f' for female)."
    }
  },
  "required": [
    "prompt"
  ],
  "additionalProperties": false
}

Endpoint

Method
POST
URL
https://app.suedeai.ai/create-music

Payment

Protocol
x402
Listed price
0.50 USDC per call on Base
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
POST https://app.suedeai.ai/create-music
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z