venice-audio-music

Venice Music / Async Audio

Music (and long-form voice) generation is asynchronous. The flow is:

POST /api/v1/audio/quote      → price in USD
POST /api/v1/audio/queue      → { queue_id }      (funds reserved)
POST /api/v1/audio/retrieve   → status or binary audio
POST /api/v1/audio/complete   → finalize & delete media

For short text-to-speech, use the synchronous venice-audio-speech endpoint instead.

Use when

• You need songs, jingles, score, soundscape, or long narration.
• The selected model uses duration-based or character-based pricing and must be priced before submission.
• The expected generation time is long enough (> 20 s) that sync call would time out.

Lifecycle

1. POST /audio/quote — price it first

curl https://api.venice.ai/api/v1/audio/quote \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "elevenlabs-music",
    "duration_seconds": 60
  }'

Response: {"quote": 0.48} (USD).

Field	Notes
model	Required. Music/audio model from GET /models?type=music.
duration_seconds	Integer or numeric string. Only if the model reports duration metadata.
character_count	Required for models with pricing.per_thousand_characters (long narration).

2. POST /audio/queue — enqueue

curl https://api.venice.ai/api/v1/audio/queue \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "elevenlabs-music",
    "prompt": "Uplifting indie-folk acoustic track, 120 BPM, major key.",
    "lyrics_prompt": "Verse 1: Walking through the city lights...\nChorus: We are the dreamers...",
    "duration_seconds": 60,
    "voice": "Aria",
    "language_code": "en",
    "speed": 1.0,
    "force_instrumental": false,
    "lyrics_optimizer": false
  }'

Response: { "model": "...", "queue_id": "uuid" }.

Field	Notes
model	Required.
prompt	Required. Describe genre, mood, tempo, instruments. Length caps in /models.
lyrics_prompt	Lyrics. Required when lyrics_required=true, rejected when supports_lyrics=false.
duration_seconds	Integer or string. Model-dependent.
force_instrumental	Only when supports_force_instrumental=true.
lyrics_optimizer	Auto-generate lyrics from prompt. Requires supports_lyrics_optimizer=true. lyrics_prompt must be empty.
voice	For voice-enabled models. See voices + default_voice in /models.
language_code	ISO 639-1. Requires supports_language_code=true.
speed	Requires supports_speed=true. Use model's min_speed/max_speed.