PulsarNovaNOVA

Documentation

Generate royalty-free instrumental music via API. Pay per generation with USDC on Base.

AI

For AI Agents

Pulsar speaks x402 — the HTTP payment protocol. Send a POST request with your payment header, get music back.

# Discovery endpoint (JSON)
GET https://pulsar.novabot.sh/api/discovery

# Generate music (requires x402 payment)
POST https://pulsar.novabot.sh/api/generate
View machine-readable discovery →

How It Works

1

Request

POST to /api/generate with a title and style description.

2

Pay

Include an X-PAYMENT header with $0.20 USDC on Base.

3

Receive

Get a job ID, poll for status, download your tracks.

API Reference

POST/api/generate
$0.20 USDC

Generate 2 unique instrumental tracks. Returns immediately with a job ID.

// Request body
{
  "title": "Sunset Vibes",
  "style": "lo-fi, hip-hop, jazzy, chill"
}
GET/api/status/:jobId
Free

Poll for job status. Returns download URLs when generation is complete.

GET/api/health
Free

Health check endpoint.

Style Ideas

Lo-fi

lo-fi, hip-hop, jazzy, vinyl crackle, mellow

Ambient

ambient, electronic, soft synth, atmospheric

Chiptune

chiptune, 8-bit, energetic, playful, retro game

Cinematic

orchestral, dramatic, brass, strings, epic

Electronic

techno, house, synth, bass, driving beat

Acoustic

acoustic guitar, warm, folk, fingerpicking