Api Endpoint

Suede Music Maker

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'.

Open interactive test console

Offering

Provider: app.suedeai.ai
Method: POST
Offering type: Api Endpoint
Transport type: http
Category: Creative
Delivery: Not provided
Pricing model: Not provided
x402 version: 2

Endpoint context

URL: https://app.suedeai.ai/create-music
MIME type: application/json
First seen: 2026-10-16T01:50:06.715Z
Last seen: 2026-11-04T08:51:01.036Z
Tags: Music, song-generation, text-to-music, audio, creative-ai

Website

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1: 0.5 USDC
Atomic price: 500000 · Network: eip155:8453 · Asset: USDC · Scheme: exact

Raw x402 terms

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "500000",
    "payTo": "0x10FF767043A1723E0BB5B9207bC37D3442cC9E4F"
  }
]

Observed health

Status: Reachable
Latest latency: 219 ms
Average latency: 565 ms
HTTP status: 405
Last checked: 2026-11-01T12:49:09.135Z
Reachability: 100% over 12 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

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

Output schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string"
    },
    "example": {
      "type": "object",
      "required": [
        "shareUrl"
      ],
      "properties": {
        "shareUrl": {
          "type": "string",
          "format": "uri",
          "description": "Public URL to listen to and download the track."
        },
        "title": {
          "type": "string",
          "description": "Title of the generated track."
        },
        "imageUrl": {
          "type": "string",
          "format": "uri",
          "description": "Cover art image URL."
        }
      }
    }
  },
  "required": [
    "type"
  ]
}