# Venice AI Audio Queue

> Venice AI Audio Queue is a paid API for AI agents from api.venice.ai, paid per call via x402, $10/call, status unknown (last checked 2026-10-11).

Queues an asynchronous audio generation request (music, speech, or narration) using a specified model and prompt, returning a queue ID for polling.

## Facts

- Endpoint: POST https://api.venice.ai/api/v1/audio/queue?utm_source=zero.xyz
- Price: $10/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/venice-ai-audio-queue-db48a86f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SYAbp2GDWW5dp7SXm8RHr

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 venice-ai-audio-queue-db48a86f -d '<json body>'
```

Example prompt: Using the Venice AI audio API, queue a music generation request with the elevenlabs-music model — prompt: 'An upbeat electronic track with energetic beats for a product launch video', duration 60 seconds, with lyrics auto-generated from the prompt.

## When to prefer this

Use this endpoint when you need asynchronous audio generation — music, narration, or voice — via Venice AI, especially when generation time may be long. It is the entry point for the Venice audio pipeline; pair it with the Retrieve endpoint to poll for completion. Prefer over the Speech endpoint when using music models like elevenlabs-music or when you need lyrics, duration control, or instrumental generation.

## Known failure modes

- 402 Payment Required — insufficient USDC balance, includes top-up instructions for x402 wallet
- 400 Bad Request — missing required fields (model or prompt), or prompt length outside model limits
- 422 Unprocessable Entity — invalid model name, unsupported parameter combination (e.g. lyrics_prompt when model doesn't support lyrics, or lyrics_optimizer=true with non-empty lyrics_prompt)
- 401 Unauthorized — missing or invalid Bearer token or X-Sign-In-With-X header
- 429 Too Many Requests — rate limit exceeded

## How this service works

Queue music / sound-effects generation.

## Output

Returns a JSON object with the queue_id (UUID to poll for status), the model used, and a status of 'QUEUED'. The queue_id must be used with the Retrieve endpoint to get the final audio result once generation completes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "model",
  "prompt"
 ],
 "properties": {
  "model": {
   "type": "string",
   "example": "elevenlabs-music",
   "description": "The model to use for audio generation."
  },
  "speed": {
   "type": "number",
   "example": 1,
   "maximum": 4,
   "minimum": 0.25,
   "description": "Optional audio speed multiplier. Only supported when `/models` reports `supports_speed=true`; use the model-specific `min_speed` and `max_speed` values."
  },
  "voice": {
   "type": "string",
   "example": "Aria",
   "description": "Optional voice selection for voice-enabled models. See `/models?type=music` for the model's supported `voices` and `default_voice`."
  },
  "prompt": {
   "type": "string",
   "example": "A warm spoken narration introducing a product launch.",
   "minLength": 1,
   "description": "The prompt describing the audio to generate. Minimum and maximum prompt lengths vary by model; inspect `/models` for `min_prompt_length` and `prompt_character_limit`."
  },
  "language_code": {
   "type": "string",
   "example": "en",
   "description": "Optional ISO 639-1 language code. Only supported when `/models` reports `supports_language_code=true`."
  },
  "lyrics_prompt": {
   "type": "string",
   "example": "Verse 1: Walking through the city lights...",
   "description": "Optional lyrics/text for lyric-capable models. Required when `/models` reports `lyrics_required=true`; unsupported when `/models` reports `supports_lyrics=false`."
  },
  "duration_seconds": {
   "anyOf": [
    {
     "type": "integer",
     "minimum": 0,
     "exclusiveMinimum": true
    },
    {
     "type": "string",
     "pattern": "^\\d+$"
    }
   ],
   "example": 60,
   "description": "Optional duration hint in seconds. Only supported for models that expose duration metadata via `/models`. Accepts either an integer or a numeric string. If omitted, the model default duration is used when available."
  },
  "lyrics_optimizer": {
   "type": "boolean",
   "example": false,
   "description": "When enabled, auto-generates lyrics from the prompt. Only supported when `/models` reports `supports_lyrics_optimizer=true`. lyrics_prompt must be empty when this is true."
  },
  "force_instrumental": {
   "type": "boolean",
   "example": false,
   "description": "Optional instrumental toggle. Only supported when `/models` reports `supports_force_instrumental=true`."
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "model",
  "queue_id",
  "status"
 ],
 "properties": {
  "model": {
   "type": "string",
   "example": "elevenlabs-music",
   "description": "The ID of the model used for audio generation."
  },
  "status": {
   "enum": [
    "QUEUED"
   ],
   "type": "string",
   "example": "QUEUED",
   "description": "The status of the audio generation request."
  },
  "queue_id": {
   "type": "string",
   "example": "123e4567-e89b-12d3-a456-426614174000",
   "description": "The ID of the audio generation request. Use this to poll for status and retrieve the result."
  }
 },
 "additionalProperties": false
}
```

## More

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