Passer au contenu principal
La synthèse vocale transforme du texte écrit en audio parlé. Choisissez un modèle TTS, sélectionnez une voix prise en charge par ce modèle, envoyez le texte à /audio/speech et enregistrez la réponse audio binaire. Utilisez ce guide pour la génération de voix standard. Si vous souhaitez créer de la parole à partir d’une voix de référence personnalisée, consultez Clonage de voix.

​
Utilisation de base

import os
from pathlib import Path

import requests

response = requests.post(
    "https://api.venice.ai/api/v1/audio/speech",
    headers={
        "Authorization": f"Bearer {os.environ['VENICE_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "model": "tts-kokoro",
        "voice": "af_sky",
        "input": "Hello, welcome to Venice Voice.",
    },
)

response.raise_for_status()
Path("speech.mp3").write_bytes(response.content)

import { writeFile } from "node:fs/promises";

const response = await fetch("https://api.venice.ai/api/v1/audio/speech", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VENICE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "tts-kokoro",
    voice: "af_sky",
    input: "Hello, welcome to Venice Voice.",
  }),
});

if (!response.ok) {
  throw new Error(await response.text());
}

await writeFile("speech.mp3", Buffer.from(await response.arrayBuffer()));

curl https://api.venice.ai/api/v1/audio/speech \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tts-kokoro",
    "voice": "af_sky",
    "input": "Hello, welcome to Venice Voice."
  }' \
  --output speech.mp3

​
Choisir un modèle et une voix

Les voix sont spécifiques au modèle. La valeur voice doit être valide pour le model choisi. Consultez la page Modèles de synthèse vocale pour parcourir les modèles et les voix disponibles. Le sélecteur de voix indique les identifiants exacts à transmettre dans votre requête.
Les identifiants de voix sont sensibles à la casse. Si vous changez de modèle TTS, mettez à jour la valeur voice en même temps.

​
Forme de la requête

ParamètreTypeRequisDescription
modelstringOuiIdentifiant du modèle de synthèse vocale.
voicestringOuiIdentifiant de voix pris en charge par le modèle sélectionné.
inputstringOuiTexte à synthétiser.

​
Conseils pour la production

  • Mettez en cache l’audio généré lorsque le texte source et la voix sont réutilisés.
  • Normalisez et relisez le texte avant la synthèse. La ponctuation influence le rythme et l’intonation.
  • Stockez la sortie avec l’extension de fichier appropriée au format de réponse du modèle.

​
Ressources connexes