agentic-commerce-catalog

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'. — $0.50 USDC via x402 on Base (chain 8453).

{
  "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"
  ]
}

AI video generation from a text prompt. Returns an 8-second 720p clip with native audio. Use for short-form video, b-roll, product shots, music-video visuals, social clips, and ads. Include sound cues (instruments, voices, weather, movement) since audio is generated from the scene; a silent scene renders near-silent by design. Async by default: poll the returned pollUrl for videoUrl, or pass ?async=false to block. — $4.99 USDC via x402 on Base (chain 8453).

{
  "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": "Return immediately with a jobId while the render runs. Can only switch async on: false is the same as omitting it, so a paid call stays asynchronous; ?async=false is the only way to force a blocking call."
    }
  },
  "required": [
    "prompt"
  ]
}

AI image generation from a text prompt. Generate album and single cover art, podcast and video thumbnails, social and campaign graphics, concept art, storyboard frames, product shots, and article illustrations. Returns one hosted still image as PNG or JPEG in square, portrait, or widescreen framing (1:1, 4:5, 9:16, 16:9, 21:9). Async by default: poll the returned pollUrl for imageUrl, or pass ?async=false to block. — $0.15 USDC via x402 on Base (chain 8453).

{
  "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'."
    },
    "asyncMode": {
      "type": "boolean",
      "description": "Return immediately with a jobId while the render runs. Can only switch async on: false is the same as omitting it, so a paid call stays asynchronous; ?async=false is the only way to force a blocking call."
    }
  },
  "required": [
    "prompt"
  ]
}

Generate one original song using a Skyfire PAY token scoped to seller service ea133c15-9ed4-4346-ad48-990b10aa1c87. The backend charges $0.50 USDC; it also accepts x402 payments. Supply the Skyfire token privately, never quote it in the answer. Paid calls queue a job; use skyfire_get_music to poll it. Do not retry a paid call without checking its outcome.

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "Original song description."
    },
    "skyfireToken": {
      "type": "string",
      "description": "Skyfire PAY or KYA-PAY token scoped to the Suede Create Music seller service. Treat as a bearer secret."
    },
    "make_instrumental": {
      "type": "boolean",
      "description": "Generate without vocals."
    }
  },
  "required": [
    "prompt",
    "skyfireToken"
  ],
  "additionalProperties": false
}

Poll a Create Music songId for the finished track. This GET is free and does not require a Skyfire token or another x402 USDC payment.

{
  "type": "object",
  "properties": {
    "songId": {
      "type": "string",
      "description": "songId returned by skyfire_create_music."
    }
  },
  "required": [
    "songId"
  ],
  "additionalProperties": false
}