Music Generation API

Generate AI-composed music tracks from text prompts. Supports instrumental and vocal tracks with custom lyrics. Powered by MiniMax Music models.

Base URL: https://api.jarvisclaw.ai/v1

Authentication

Both methods are supported — all requests settle via x402 on-chain:

Method	Header	Description
API Key	Authorization: Bearer sk-...	Platform signs x402 from your HD wallet automatically
Private Key (x402)	Automatic via SDK	Agent signs x402 directly from its own wallet

See Agent Payments (x402) for full details on how both methods work.

Endpoints

POST /v1/audio/generations

Generate a music track from a text prompt.

Name	Type	Required	Description
model	string	Yes	Model identifier (auto/music, minimax/music-2.5+)
prompt	string	Yes	Description of the music to generate (genre, mood, tempo)
instrumental	boolean	No	Generate instrumental only (no vocals) (default: false)
lyrics	string	No	Custom lyrics for the track (ignored if instrumental is true)
duration_seconds	integer	No	Target duration in seconds (max 180) (default: 180)

Request

{
  "model": "auto/music",
  "prompt": "Upbeat electronic dance track with synth arpeggios and driving bass",
  "instrumental": true,
  "duration_seconds": 120
}

Response

Music generation is asynchronous, on the same job flow as video. The POST returns a job handle, not the finished track:

{
  "id": "minimax:music_ae260c45bdb7453c8bbe",
  "status": "queued",
  "model": "minimax/music-2.5+",
  "price": {
    "amount": "0.1575",
    "currency": "USD"
  },
  "poll_url": "/v1/audio/generations/minimax%3Amusic_ae260c45bdb7453c8bbe?..."
}

If the track happens to be ready immediately, status is completed and no poll_url is returned.

GET /v1/audio/generations/:id

Poll the job. Call every 5–10s until status is completed or failed. Job IDs are provider-prefixed, so the : must be URL-encoded (%3A) — or just use the poll_url returned by the POST, which is already encoded.

Polling is free; the read reuses the original payment.

A failed job returns:

{
  "id": "minimax:music_ae260c45bdb7453c8bbe",
  "status": "failed",
  "error": "upstream generation failed",
  "retryable": true
}

Check retryable before resubmitting — a non-retryable failure will fail again on the same input.

Pricing

Model	Price	Notes
auto/music	$0.1575/track	Auto-routes to best available
minimax/music-2.5+	$0.1575/track	Up to ~3 minutes output

Reference rates. Read price.amount in the response for the exact charge. Polling (GET) is free.

Code Examples

cURL

curl -X POST https://api.jarvisclaw.ai/v1/audio/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto/music",
    "prompt": "Chill lo-fi hip hop beat with rain sounds",
    "instrumental": true,
    "duration_seconds": 120
  }'

Python (API Key)

from jarvisclaw import AudioClient

audio = AudioClient(api_key="sk-your-api-key")

# Smart route (auto-selects best model)
result = audio.music("Chill lo-fi hip hop beat with rain sounds", instrumental=True)

# Save the audio file
with open("track.mp3", "wb") as f:
    f.write(result.content)
print(f"Saved {len(result.content)} bytes, type: {result.content_type}")

Python (x402 Agent)

from jarvisclaw import AudioClient

# ─── Option A: Base chain (EVM) ───
# Hex private key → USDC on Base (Chain ID 8453)
audio = AudioClient(private_key="0x<evm-private-key>")

# ─── Option B: Solana ───
# Base58 keypair → USDC SPL on Solana mainnet
# audio = AudioClient(private_key="<solana-bs58-keypair>")

# SDK auto-detects chain from key format — no config needed

# Generate music (returns audio bytes, takes 1-3 min)
result = audio.music("Chill lo-fi hip hop beat with rain sounds", instrumental=True)

# Save the audio file
with open("track.mp3", "wb") as f:
    f.write(result.content)
print(f"Saved {len(result.content)} bytes")

# ─── Don't want to block? ───
# wait=False returns a MusicJob immediately instead of polling for you
job = audio.music("Chill lo-fi hip hop beat", instrumental=True, wait=False)
if job.done():
    track = job.result(timeout=300)

Go (API Key)

package main

import (
    "context"
    "fmt"
    jc "github.com/api-jarvisclaw/go-sdk/v2"
)

func main() {
    ctx := context.Background()
    ac, _ := jc.NewAudioClient(jc.WithAPIKey("sk-your-api-key"))

    // Smart route (auto-selects best model)
    result, _ := ac.Music(ctx, "Chill lo-fi hip hop beat with rain sounds",
        jc.WithInstrumental(true))
    fmt.Printf("Track URL: %s\n", result.URL)

    // With explicit model
    result, _ = ac.Music(ctx, "Chill lo-fi hip hop beat with rain sounds",
        jc.WithAudioModel("auto/music"), jc.WithInstrumental(true))
    fmt.Printf("Track URL: %s\n", result.URL)
}

Go (x402 Agent)

package main

import (
    "context"
    "fmt"
    jc "github.com/api-jarvisclaw/go-sdk/v2"
)

func main() {
    ctx := context.Background()

    // x402 Agent wallet — pays per-call via USDC on Base (Chain ID 8453)
    ac, _ := jc.NewAudioClient(jc.WithPrivateKey("0x<evm-private-key>"))

    // Smart route (auto-selects best model)
    result, _ := ac.Music(ctx, "Chill lo-fi hip hop beat with rain sounds",
        jc.WithInstrumental(true))
    fmt.Printf("Track URL: %s\n", result.URL)

    // With explicit model
    result, _ = ac.Music(ctx, "Chill lo-fi hip hop beat",
        jc.WithAudioModel("auto/music"), jc.WithInstrumental(true))
    fmt.Printf("Track URL: %s\n", result.URL)
}