Audio

/api/v1/audio/queue

Queue a new audio generation request.

Authentication: This endpoint accepts either a Bearer API key or a SIGN-IN-WITH-X header for x402 wallet-based authentication. The legacy X-Sign-In-With-X header is also accepted during migration. When using x402, a 402 Payment Required response indicates insufficient balance and includes top-up instructions.

post/api/v1/audio/queue

Request

  • Base URL: https://api.venice.ai
  • URL: https://api.venice.ai/api/v1/audio/queue
  • Auth: one of:
    • HTTP bearer
    • API key in header SIGN-IN-WITH-X

Request body

modelstring required

The model to use for audio generation. Voice-changer models are not supported here; use the /api/v1/audio/voice-changer endpoints instead.

promptstring required

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.

lyrics_promptstring

Optional lyrics/text for lyric-capable models. Required when /models reports lyrics_required=true; unsupported when /models reports supports_lyrics=false.

force_instrumentalboolean

Optional instrumental toggle. Only supported when /models reports supports_force_instrumental=true.

lyrics_optimizerboolean

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.

loopboolean

Render the clip so its end splices back into its start without an audible seam. Only supported when /models reports supports_loop=true.

voicestring

Optional voice selection for voice-enabled models. See /models?type=music for the model's supported voices and default_voice.

language_codestring

Optional ISO 639-1 language code. Only supported when /models reports supports_language_code=true.

speednumber

Optional audio speed multiplier. Only supported when /models reports supports_speed=true; use the model-specific min_speed and max_speed values.

Example request

{
  "model": "elevenlabs-music",
  "prompt": "A warm spoken narration introducing a product launch.",
  "lyrics_prompt": "Verse 1: Walking through the city lights...",
  "voice": "Aria",
  "language_code": "en",
  "speed": 1
}

Response

Audio generation request queued successfully

modelstring required

The ID of the model used for audio generation. Voice-changer models are not supported on /api/v1/audio/retrieve or /api/v1/audio/complete; use the /api/v1/audio/voice-changer endpoints instead.

queue_idstring required

The ID of the audio generation request. Use this to poll for status and retrieve the result.

status'QUEUED' required

The status of the audio generation request.

Example response

{
  "model": "elevenlabs-music",
  "queue_id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "QUEUED"
}

Changes

No recorded changes to this operation across all 1 revision of this API.