Skip to content
clusters: prooflayer · edgemarket · edgefinance · synthforge · mediakit · wordmint · webprobe · locale · comppoint
$ man music-generate

/music-generate(1)

agentutility / synthforge / music-generate
PRICE / CALL
$0.05
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
synthforge
CATEGORY
uncategorized
STATUS
live
NAME
music-generate music generation / text-to-music / ai music / generative song / instrumental and vocal music
SYNOPSIS
POST https://x402.org/v1/music-generate
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }
↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.
DESCRIPTION

Music generation / text-to-music / AI music / generative song / instrumental and vocal music. Text-to-music via Venice with the minimax-music-v26 model. Optional lyrics input. Duration 5-120 seconds. Returns a permanent fal-hosted audio URL (or a Venice-hosted URL when Venice already provides one).

INPUTrequest schema
propertytypedescriptionreq?
promptstringGenre / mood / instrumentation description.required
duration_secondsnumberLength in seconds. Range [5, 120]. Default 30.optional
lyricsstringOptional lyrics. The model will sing them.optional
modelstringOverride the model. Default 'minimax-music-v26'.optional
OUTPUTresponse shape
fieldtypedescription
audio_urlstringPermanent URL to the generated audio file, fal-hosted by default or Venice-hosted when Venice supplies one.
duration_secondsstringLength of the generated track in seconds, between 5 and 120 as requested in the input.
modelstringModel identifier used to generate the track, typically minimax-music-v26 on Venice.
promptstringText prompt describing the music to generate, echoed back from the input for reference.
venice_request_idstringVenice-side request identifier for the generation job, useful for tracing or support follow-up.
sourcestringOrigin of the audio URL, either fal (re-hosted) or venice (direct Venice-hosted asset).
EXAMPLEStwo ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/music-generate \
  -H 'Content-Type: application/json' \
  -d '{ }'
first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.
EXAMPLE 2 · mcp
# install once
claude mcp add x402 --command "npx x402-deployer-mcp"

# then ask Claude Code:
# "use the music-generate tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
tags
synthforgemusic-generationtext-to-musicai-musicgenerative-audioinstrumentalvocalsminimax-music
methods
POST
cluster
synthforge
price
$0.05 USDC per call
ADJACENTother endpoints in synthforge
endpointdescriptionprice
text-to-speechText to speech / TTS / voice generator.$0.05
voiceText-to-speech / TTS / voice synthesis.$0.05
remove-bgAI background remover / background eraser / cutout tool.$0.08
image-editImage edit / instruction-based image edit / text-driven photo edit / nano-banana image editor / GPT-image-2 edit.$0.02
image-inpaintImage inpainting / mask-based image edit / fill in masked region / object replacement / face swap (mask-driven) / generative fill.$0.02
image-generateImage generate (fast/cheap) / text-to-image / AI art.$0.01
sound-effect-generateSound effect generation / text-to-SFX / Foley generator / ElevenLabs sound effects / ambient audio synth.$0.01
image-generate-proImage generate (pro) / premium text-to-image / Flux 2 Pro / Recraft / Seedream / Qwen Image 2 Pro / xAI Grok Imagine.$0.10
SEE ALSO
agentutility(7) · synthforge(7) · x402(7) · mcp(7) · llms.txt · registry.json · bazaar.x402.org