{"uid":"cap_SYAbp2GDWW5dp7SXm8RHr","slug":"venice-ai-audio-queue-db48a86f","name":"Venice AI Audio Queue","description":"Queue music / sound-effects generation.","url":"https://api.venice.ai/api/v1/audio/queue?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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},"responseSchema":{"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},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"10","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$10/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"10","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"10","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xzt8I3qJsLWSn-uyves_C","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"10","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Queues an asynchronous audio generation request (music, speech, or narration) using a specified model and prompt, returning a queue ID for polling.","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:46:51.258Z","isFirstParty":false,"canonicalSlug":"venice-ai-audio-queue-db48a86f"}