Musique et effets sonores

La génération de musique et d’effets sonores est asynchrone. Choisissez un modèle, demandez un devis, mettez la génération en file d’attente, puis interrogez régulièrement jusqu’à ce que Venice renvoie le fichier audio terminé.

Les modèles de changeur de voix ne sont pas acceptés sur ces endpoints. Convertissez un enregistrement source avec l’API Changeur de voix à la place.

Choisir un modèle

Parcourez les Modèles de musique et d’effets sonores pour connaître les IDs de modèles actuels, la tarification, les limites de durée et les fonctionnalités prises en charge. Vous pouvez également découvrir les capacités des modèles à l’exécution :

curl "https://api.venice.ai/api/v1/models?type=music" \
  -H "Authorization: Bearer $VENICE_API_KEY"

Vérifiez les métadonnées de chaque modèle avant de définir des champs optionnels comme duration_seconds, lyrics_prompt, force_instrumental ou loop. Les champs non pris en charge provoquent une réponse HTTP 400.

Flux de génération

Endpoint	Objectif
`POST /audio/quote`	Estimer le coût de génération en USD
`POST /audio/queue`	Démarrer une génération de musique ou d’effet sonore
`POST /audio/retrieve`	Interroger le travail et télécharger l’audio terminé
`POST /audio/complete`	Supprimer les médias stockés après téléchargement

1. Obtenir un devis

Obtenez un devis pour la requête avant de générer le média. Incluez le même modèle et la même durée que ceux que vous prévoyez d’envoyer à l’endpoint de mise en file d’attente.

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

La réponse contient le coût estimé en USD :

{
  "quote": 0.69
}

Certains modèles sont facturés par paliers de durée : une requête elevenlabs-music de 30 secondes est donc tarifée au palier de 60 secondes. Consultez le champ pricing de chaque modèle dans GET /models?type=music pour connaître ses paliers ou son tarif à la seconde.

2. Mettre la génération en file d’attente

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": "Warm cinematic strings with a gentle piano melody, hopeful and spacious",
    "duration_seconds": 30,
    "force_instrumental": true
  }'

curl https://api.venice.ai/api/v1/audio/queue \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "elevenlabs-sound-effects-v2",
    "prompt": "Ocean waves rolling onto a pebble beach at night",
    "duration_seconds": 10
  }'

Une requête réussie renvoie le modèle et un ID de file d’attente :

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

Enregistrez à la fois model et queue_id ; les endpoints retrieve et complete en ont besoin.

3. Interroger et télécharger

Appelez /audio/retrieve avec les valeurs de la réponse de mise en file d’attente :

curl https://api.venice.ai/api/v1/audio/retrieve \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "elevenlabs-music",
    "queue_id": "123e4567-e89b-12d3-a456-426614174000"
  }' \
  --output response.bin

Inspectez le Content-Type de la réponse :

Content-Type	Signification	Action
`application/json`	La génération est encore en cours	Lisez les champs de timing, patientez et interrogez à nouveau
Tout autre type, comme `audio/mpeg`, `audio/wav`, `audio/flac` ou `audio/mp4`	La génération est terminée	Enregistrez le corps binaire avec l’extension correspondante (`.m4a` pour `audio/mp4`)

Le type audio dépend du format de sortie du modèle. Consultez default_format et supported_formats dans les métadonnées du modèle ; par exemple, les modèles qui produisent du m4a renvoient audio/mp4. Une réponse en cours de traitement ressemble à ceci :

{
  "status": "PROCESSING",
  "average_execution_time": 20000,
  "execution_duration": 5200
}

Les deux valeurs de temps sont exprimées en millisecondes.

Exemple complet

Cet exemple Python met en file d’attente de la musique instrumentale, interroge toutes les cinq secondes et enregistre le résultat avec une extension basée sur son type de contenu.

import os
import time
from pathlib import Path

import requests

BASE_URL = "https://api.venice.ai/api/v1"
HEADERS = {
    "Authorization": f"Bearer {os.environ['VENICE_API_KEY']}",
    "Content-Type": "application/json",
}

generation = {
    "model": "elevenlabs-music",
    "prompt": "Warm cinematic strings with a gentle piano melody, hopeful and spacious",
    "duration_seconds": 30,
    "force_instrumental": True,
}

quote = requests.post(f"{BASE_URL}/audio/quote", json={
    "model": generation["model"],
    "duration_seconds": generation["duration_seconds"],
})
quote.raise_for_status()
print(f"Estimated cost: ${quote.json()['quote']:.2f}")

queued = requests.post(f"{BASE_URL}/audio/queue", headers=HEADERS, json=generation)
queued.raise_for_status()
job = queued.json()

content_type_to_extension = {
    "audio/mpeg": ".mp3",
    "audio/wav": ".wav",
    "audio/flac": ".flac",
    "audio/mp4": ".m4a",
}

while True:
    result = requests.post(
        f"{BASE_URL}/audio/retrieve",
        headers=HEADERS,
        json={"model": job["model"], "queue_id": job["queue_id"]},
    )
    result.raise_for_status()
    content_type = result.headers.get("Content-Type", "").split(";")[0].strip()

    if content_type == "application/json":
        status = result.json()
        print(f"Status: {status['status']}")
        time.sleep(5)
        continue

    extension = content_type_to_extension.get(content_type, ".bin")
    output = Path("generated-audio" + extension)
    output.write_bytes(result.content)
    print(f"Saved {output}")
    break

requests.post(
    f"{BASE_URL}/audio/complete",
    headers=HEADERS,
    json={"model": job["model"], "queue_id": job["queue_id"]},
).raise_for_status()

L’endpoint quote ne nécessite pas d’authentification, mais les requêtes queue, retrieve et complete en ont besoin.

Conseils de prompt

Pour la musique, décrivez le genre, les instruments, l’ambiance, le tempo, la structure et si des voix sont souhaitées.
Pour les effets sonores, décrivez la source, l’environnement, l’intensité, le timing et la perspective.
N’utilisez lyrics_prompt que lorsque le modèle sélectionné prend en charge les paroles.
N’utilisez force_instrumental ou loop que lorsque les métadonnées du modèle indiquent leur prise en charge.

Documentation

Démarrage

Texte et chat

Image

Vidéo

Audio

Recherche et RAG

Agents et intégrations

Outils de code

Outils pour agents

SDK et frameworks

Choisir un modèle

Flux de génération

1. Obtenir un devis

2. Mettre la génération en file d’attente

3. Interroger et télécharger

Exemple complet

Conseils de prompt

Ressources connexes

​Choisir un modèle

​Flux de génération

​1. Obtenir un devis

​2. Mettre la génération en file d’attente

​3. Interroger et télécharger

​Exemple complet

​Conseils de prompt

​Ressources connexes

Choisir un modèle

Flux de génération

1. Obtenir un devis

2. Mettre la génération en file d’attente

3. Interroger et télécharger

Exemple complet

Conseils de prompt

Ressources connexes