# ElevenLabs Music API (via ZeroClick)

> ElevenLabs Music API (via ZeroClick) is a paid API for AI agents from api.zeroclick.ac, paid per call via MPP, price unknown, status unknown (last checked 2026-09-15).

Generates original music audio files from a natural-language prompt or structured composition plan, returning base64-encoded MP3/WAV audio with a song identifier.

## Facts

- Endpoint: POST https://api.zeroclick.ac/mpp/elevenlabs-music-api-vq4khs
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Provider: api.zeroclick.ac
- Website: https://api.zeroclick.ac
- Canonical page: https://www.zero.xyz/c/api-zeroclick-ac-elevenlabs-music-api-b847cbac
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GGrpuSFI5meqhU4gCJbRI

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 api-zeroclick-ac-elevenlabs-music-api-b847cbac -d '<json body>'
```

Example prompt: Generate me a 45-second instrumental lo-fi hip-hop track — calm and relaxed mood, no vocals — and give it to me as an MP3 file; use seed 42 so I can reproduce it later.

## When to prefer this

Choose this endpoint when you need to programmatically generate original music audio files (3 seconds to 10 minutes) via ElevenLabs' music_v1 model, especially when you want to pass a natural-language prompt or a detailed composition plan, require specific output formats (MP3/WAV), need deterministic/reproducible generation via a seed, or want C2PA provenance signing. Avoid if you need licensed commercial samples or copyrighted song reproduction.

## Known failure modes

- Mutually exclusive fields provided (both prompt and composition_plan) — validation error
- Upstream rate limiting (429) from ElevenLabs
- Upstream service failure (5xx) — refund policy applies
- Payment authorization failure
- Generation timeout exceeding 30,000 ms
- Unsupported output_format value
- music_length_ms outside 3000–600000 ms range

## How this service works

Use this listing when an agent needs programmatic music generation. Supply either a natural-language 'prompt' or a structured 'composition_plan' (they are mutually exclusive). Validate response headers for 'song-id' and 'content-type'. If a timeout or upstream 5xx occurs, mark the call as failed and follow refund policy. Avoid sending copyrighted requests without rights. Refer to upstream docs for supported output_format values and limits.

Use when: Generate short to long musical pieces programmatically (3s–600s).; When you need deterministic runs (use seed) or repeatable composition via composition_plan.; When different output formats (mp3/wav) are required for downstream playback or processing.

Do not use when: When you need to reproduce an existing copyrighted song without rights or license.; For transient prompts that do not require an external audio artifact (text-only effects).; When the buyer requires guaranteed artist-identical vocals or licensed commercial samples without appropriate rights.

Failure modes: Invalid buyer input (e.g., mutually exclusive fields provided).; Upstream rate limiting or 429 responses.; Upstream 5xx service failure.; Payment authorization failure.; Generation timeout (exceeds 30000 ms configured timeout).

Price: 0.05 USDC per request.

## Output

Returns a JSON object containing base64-encoded audio bytes (bodyBase64), the byte length of the audio, the MIME type (e.g. audio/mpeg or audio/wav), and response headers including a unique song-id and content-type assigned by ElevenLabs.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [],
 "properties": {
  "seed": {
   "type": [
    "integer",
    "null"
   ],
   "maximum": 2147483647,
   "minimum": 0,
   "description": "Optional random seed (0..2^31-1). When provided, generation may be deterministic. Do not provide together with prompt for seed-only workflows."
  },
  "prompt": {
   "type": [
    "string",
    "null"
   ],
   "maxLength": 4100,
   "description": "Natural-language prompt to guide the music generation (up to 4100 chars). Mutually exclusive with composition_plan."
  },
  "model_id": {
   "enum": [
    "music_v1"
   ],
   "type": "string",
   "default": "music_v1",
   "description": "Model identifier. Currently only 'music_v1' is supported by the upstream API."
  },
  "output_format": {
   "type": "string",
   "description": "Desired audio format (e.g. 'mp3_44100_128', 'wav_48000'). Use formats supported by the upstream service."
  },
  "sign_with_c2pa": {
   "type": [
    "boolean",
    "null"
   ],
   "default": false,
   "description": "If true and supported by upstream, attach a C2PA provenance signature to the artifact."
  },
  "music_length_ms": {
   "type": [
    "integer",
    "null"
   ],
   "maximum": 600000,
   "minimum": 3000,
   "description": "Requested length in milliseconds (3,000–600,000). If omitted, the model will choose a suitable length."
  },
  "composition_plan": {
   "type": [
    "object",
    "null"
   ],
   "description": "Structured composition plan describing sections, instruments, tempo, etc. Mutually exclusive with prompt."
  },
  "force_instrumental": {
   "type": [
    "boolean",
    "null"
   ],
   "default": false,
   "description": "Request instrumental output where feasible (reduce or avoid vocals)."
  },
  "store_for_inpainting": {
   "type": [
    "boolean",
    "null"
   ],
   "default": false,
   "description": "When true, instructs upstream to retain an artifact for potential inpainting workflows if supported."
  },
  "respect_sections_durations": {
   "type": [
    "boolean",
    "null"
   ],
   "default": true,
   "description": "When composition_plan is provided, attempt to respect specified section durations."
  }
 },
 "additionalProperties": true
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "contentType",
  "byteLength",
  "bodyBase64",
  "responseHeaders"
 ],
 "properties": {
  "bodyBase64": {
   "type": "string",
   "description": "Base64-encoded audio bytes (decoded length equals byteLength)."
  },
  "byteLength": {
   "type": "integer",
   "description": "Number of bytes in the decoded audio payload."
  },
  "contentType": {
   "type": "string",
   "description": "MIME type of the audio (e.g., 'audio/mpeg', 'audio/wav')."
  },
  "responseHeaders": {
   "type": "object",
   "required": [
    "content-type",
    "song-id"
   ],
   "properties": {
    "song-id": {
     "type": "string",
     "description": "Upstream song identifier returned by the service."
    },
    "content-type": {
     "type": "string",
     "description": "Content-Type header value returned by the upstream service."
    }
   },
   "additionalProperties": true
  }
 },
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-zeroclick-ac-elevenlabs-music-api-b847cbac/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.zeroclick.ac](https://www.zero.xyz/host/api.zeroclick.ac/llms.txt)