create_music

Create a full-length, fully owned, rights-aware song from a prompt, with optional custom lyrics and style control. Returns a complete multi-minute track with verses, a chorus, and full arrangement, never a clip or preview. Suede generates and registers it inside the programmable-IP and licensing workflow. — $0.50 USDC via x402 on Base (chain 8453).

Parameters8

prompt	string	required	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'.
durationSeconds	integer	optional	Duration of the track in seconds. Defaults to a full-length song.
style	string	optional	Specific musical style or genre tag (e.g., 'Hip Hop', 'Ambient', 'Rock'). Helping the AI focus on a specific sound.
custom_mode	boolean	optional	Set to true to use your own lyrics provided in the 'lyrics' field.
lyrics	string	optional	Your custom lyrics. Required if custom_mode is true.
make_instrumental	boolean	optional	If true, generates a track without vocals.
vocal_gender	string	optional	Preferred gender for the vocalist ('m' for male, 'f' for female).
tags	string	optional	Comma-separated keywords to tag the generated file.

Raw schema

{
  "type": "object",
  "properties": {
    "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'."
    },
    "durationSeconds": {
      "type": "integer",
      "minimum": 5,
      "maximum": 120,
      "default": 120,
      "description": "Duration of the track in seconds. Defaults to a full-length song."
    },
    "style": {
      "type": "string",
      "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",
      "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",
      "enum": [
        "m",
        "f"
      ],
      "description": "Preferred gender for the vocalist ('m' for male, 'f' for female)."
    },
    "tags": {
      "type": "string",
      "description": "Comma-separated keywords to tag the generated file."
    }
  },
  "required": [
    "prompt"
  ]
}

agent_video

Generate a fully owned short-form music-video clip for a song, product, or campaign. Renders creator-owned video you can pair with Suede's full-length song endpoints. Async callers (?async=true or PAYMENT-SIGNATURE-authenticated requests, which auto-async) get back a jobId and pollUrl; poll GET /agent/video/{jobId} — no additional payment required — until status is 'completed' and videoUrl is set. — $6.99 USDC via x402 on Base (chain 8453).

Parameters7

prompt	string	required	Narrative or visual prompt to drive the music video concept.
durationSeconds	integer	optional	Clip length in seconds (default 8).
aspectRatio	string	optional	Desired frame aspect ratio.
resolution	string	optional	Target rendering resolution.
model	string	optional	Optional model preset variant. Leave unset for the default.
seed	integer	optional	Optional random seed for reproducible renders.
asyncMode	boolean	optional	If true, return immediately while the video renders asynchronously.

Raw schema

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "Narrative or visual prompt to drive the music video concept."
    },
    "durationSeconds": {
      "type": "integer",
      "description": "Clip length in seconds (default 8)."
    },
    "aspectRatio": {
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "description": "Desired frame aspect ratio."
    },
    "resolution": {
      "type": "string",
      "enum": [
        "720p",
        "1024p"
      ],
      "description": "Target rendering resolution."
    },
    "model": {
      "type": "string",
      "description": "Optional model preset variant. Leave unset for the default."
    },
    "seed": {
      "type": "integer",
      "description": "Optional random seed for reproducible renders."
    },
    "asyncMode": {
      "type": "boolean",
      "description": "If true, return immediately while the video renders asynchronously."
    }
  },
  "required": [
    "prompt"
  ]
}

agent_image

Generate a single still image from a text prompt — cover art, promo art, or a standalone visual for a track or campaign. Renders creator-owned artwork via Suede's programmable-IP stack. Async callers (?async=true or PAYMENT-SIGNATURE-authenticated requests, which auto-async) get back a jobId and pollUrl; poll GET /agent/image/{jobId} — no additional payment required — until status is 'completed' and imageUrl is set. — $0.15 USDC via x402 on Base (chain 8453).

Parameters2

prompt	string	required	Image description — subject, style, composition.
aspectRatio	string	optional	Aspect ratio, e.g. '1:1', '16:9', '9:16'.

Raw schema

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "Image description — subject, style, composition."
    },
    "aspectRatio": {
      "type": "string",
      "description": "Aspect ratio, e.g. '1:1', '16:9', '9:16'."
    }
  },
  "required": [
    "prompt"
  ]
}

io.github.JasonColapietro/agentic-commerce-catalog

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

create_music

agent_video

agent_image

Install

Remote endpoint

Related servers