# 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 x402 or MPP, $0.15/call, status unknown (last checked 2026-09-15, last successful call 2026-06-02).

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

## Facts

- Endpoint: POST https://api.zeroclick.ac/x402/elevenlabs-music-api-vq4khs
- Price: $0.15/call
- Payment: x402, MPP
- Status: unknown
- Last checked: 2026-09-15
- Last successful call: 2026-06-02
- Success rate: 50% of calls made through Zero
- Activations on Zero: 7
- Provider: api.zeroclick.ac
- Website: https://api.zeroclick.ac
- Canonical page: https://www.zero.xyz/c/api-zeroclick-ac-elevenlabs-music-api-2d8874d5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OUhsKqKQsXPCmUUGJihvL

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-2d8874d5 -d '<json body>'
```

Example prompt: Generate a 45-second upbeat electronic dance track with no vocals — use the music_v1 model and return it as an mp3_44100_128 file so I can drop it into the video editor.

## When to prefer this

Choose this endpoint when you need to programmatically generate original music audio artifacts (not text descriptions) with control over length (3s–600s), output format (mp3/wav), and optionally reproducible output via seed or structured composition plans. Prefer this over text-to-speech or sound-effects APIs when the goal is full musical composition with melody, instrumentation, and structure.

## Known failure modes

- Both prompt and composition_plan provided simultaneously — mutually exclusive fields error
- music_length_ms out of range (below 3000ms or above 600000ms) — validation error
- Unsupported output_format value — upstream rejection
- Upstream ElevenLabs 429 rate limit — too many requests error
- Upstream 5xx service failure — mark call as failed and follow refund policy
- Generation timeout exceeding 30000ms configured limit
- Payment authorization failure — transaction not completed
- Copyright-violating prompt rejected by upstream policy

## 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 an object containing base64-encoded audio bytes (bodyBase64), the byte count (byteLength), the MIME type (contentType such as 'audio/mpeg'), and response headers including a unique song-id and content-type assigned by the upstream ElevenLabs service.

## 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-2d8874d5/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)