# BlockRun Audio Generation

> BlockRun Audio Generation is a paid API for AI agents from blockrun.ai, paid per call via x402, $0.105/call, status unknown (last checked 2026-09-15).

Generates AI music tracks from a text prompt and optional lyrics, with configurable duration and instrumental mode, billed per-call in USDC.

## Facts

- Endpoint: POST https://blockrun.ai/api/v1/audio/generations
- Price: $0.105/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockrun-audio-generation-dfdd55da
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_II7VCVhtYqeOB-rrI45tu

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability blockrun-audio-generation-dfdd55da -d '<json body>'
```

Example prompt: Generate a 60-second upbeat electronic instrumental track with a futuristic synthwave vibe — no vocals, just pure background music for a product demo video.

## When to prefer this

Choose this endpoint when you need pay-per-call AI music generation without managing API keys, and want settlement in USDC on Base or Solana. Ideal for agents that need to generate music tracks on demand from style prompts or lyrics, especially within a crypto-native or x402-compatible payment workflow.

## Known failure modes

- Invalid or unsupported model ID returns an error
- Duration outside the 5–240 second range is rejected
- Missing required prompt field causes a validation error
- Insufficient USDC balance or failed x402 payment results in 402 Payment Required
- Overly long or malformed lyrics may cause generation failure

## How this service works

Pay for the outcome. One endpoint for every model, tool and data source an agent needs — each call priced before it runs, at the best value per dollar. 103 models and 100 data and tool APIs.

## Output

An AI-generated audio file (music track) matching the requested style, lyrics, and duration. The call is billed at $0.105 USDC per generation, settled on Base or Solana.

## Example request

```json
{
 "model": "minimax/music-2.5+",
 "prompt": "upbeat electronic dance music with synthesizers",
 "instrumental": true,
 "duration_seconds": 30
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "model": {
   "type": "string",
   "description": "Audio model ID (e.g., minimax/music-2.5+)"
  },
  "lyrics": {
   "type": "string",
   "description": "Optional lyrics for the track"
  },
  "prompt": {
   "type": "string",
   "description": "Music style or description prompt"
  },
  "instrumental": {
   "type": "boolean",
   "description": "Generate instrumental (no vocals)"
  },
  "duration_seconds": {
   "type": "integer",
   "description": "Target duration in seconds (5-240, default 30)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockrun-audio-generation-dfdd55da/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from blockrun.ai](https://www.zero.xyz/host/blockrun.ai/llms.txt)