{"uid":"cap_wdSi3YEoX5Dx0sfiaAaz0","slug":"suede-labs-ai-music-generator-4a03a85a","name":"Suede Labs AI Music Generator","description":"Create unique music tracks on the blockchain using our artificial intelligence agents","url":"https://app.suedeai.xyz/create-music","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"tags":{"type":"string","description":"Comma-separated keywords to tag the generated file."},"style":{"type":"string","description":"Specific musical style or genre tag (e.g., 'Hip Hop', 'Ambient', 'Rock'). Helping the AI focus on a specific sound."},"lyrics":{"type":"string","description":"Your custom lyrics. Required if custom_mode is true."},"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'."},"custom_mode":{"type":"boolean","description":"Set to true to use your own lyrics provided in the 'lyrics' field."},"vocal_gender":{"enum":["m","f"],"type":"string","description":"Preferred gender for the vocalist ('m' for male, 'f' for female)."},"make_instrumental":{"type":"boolean","description":"If true, generates a track without vocals."}}},"responseSchema":{"type":"json","example":{}},"example":{"request":{"tags":"synthwave,80s,electronic,neon,upbeat","style":"Synthwave","prompt":"Upbeat synthwave track with neon atmosphere and driving synthesizer bass","vocal_gender":"m","make_instrumental":true},"response":{"songId":"9b3ba0b0-fd2f-42d1-912e-f0aba07f3f33","status":"processing","pollUrl":"https://app.suedeai.ai/api/songs/9b3ba0b0-fd2f-42d1-912e-f0aba07f3f33","shareUrl":"https://app.suedeai.ai/share/9b3ba0b0-fd2f-42d1-912e-f0aba07f3f33"}},"exampleRequest":{"tags":"synthwave,80s,electronic,neon,upbeat","style":"Synthwave","prompt":"Upbeat synthwave track with neon atmosphere and driving synthesizer bass","vocal_gender":"m","make_instrumental":true},"tags":["x402"],"displayCostAmount":"0.2","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LCJc0lRXN5jdJuPnTmPcP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates unique AI-composed music tracks with optional custom lyrics, vocal gender selection, and genre/style control, recorded on the blockchain","exampleAgentPrompt":"Can you create an upbeat 80s synthwave track with driving bass and neon atmosphere using Suede Labs — make it instrumental, no vocals, and tag it as 'retro, electronic, energetic'?","exampleUseCases":[{"title":"Generate branded jingle with custom lyrics","prompt":"I need you to compose a catchy jingle for our product launch using Suede Labs. Make it upbeat pop, about 30 seconds long, with female vocals singing our company tagline, and make sure it gets recorded on the blockchain so we have proof of creation."},{"title":"Create background music for video content","prompt":"Can you generate some ambient lo-fi hip hop beats using Suede Labs for my YouTube videos? I want instrumental tracks, maybe 3-4 minutes each, with a chill vibe and electronic production style. They should be unique so I don't have copyright issues."},{"title":"Produce AI rap track with custom verses","prompt":"Use Suede Labs to make a rap track where I provide my own lyrics and verses. I want male vocals, hard-hitting trap beat production, and something that sounds professional enough to share on streaming platforms. Record it on blockchain to prove I created it."}],"resultDescription":"A JSON response containing details about the newly generated AI music track, including a reference or link to the blockchain-recorded audio file.","failureModes":["Missing prompt when custom_mode is false — returns validation error","lyrics field empty when custom_mode is true — returns error requiring lyrics","Invalid vocal_gender value outside 'm'/'f' enum — schema validation error","Insufficient USDC balance or payment failure — 402 payment required error","Conflicting make_instrumental:true with lyrics/vocal_gender fields — may produce unexpected output or error","Service unavailable or AI generation timeout — 5xx error"],"whenToPreferThis":"Use this endpoint when you need to generate an original AI-composed music track, especially when blockchain provenance of the audio asset is important, or when you want granular control over genre, lyrics, vocal gender, and instrumental vs. vocal output. Prefer this over generic audio APIs when the user wants a fully composed song rather than audio effects or speech synthesis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T16:56:21.584Z","isFirstParty":false}