Synthèse vocale

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 vocal.

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

Le corps de la réponse en cas de succès est de l’audio binaire dans le format par défaut du modèle, et non du JSON. tts-kokoro produit actuellement du MP3 par défaut.

Choisir un modèle et une voix

Les voix sont spécifiques au modèle. La valeur voice doit être valide pour le model que vous choisissez. 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ètre	Type	Requis	Description
`model`	string	Oui	Identifiant du modèle de synthèse vocale.
`voice`	string	Oui	Identifiant de voix pris en charge par le modèle sélectionné.
`input`	string	Oui	Texte à synthétiser, jusqu’à 4096 caractères.
`response_format`	string	Non	Format de sortie demandé : `mp3`, `opus`, `aac`, `flac`, `wav` ou `pcm`. Les formats pris en charge et la valeur par défaut dépendent du modèle.

Format de sortie

Vous pouvez omettre response_format pour utiliser la valeur par défaut du modèle. Avant de choisir une extension de fichier ou de remplacer le format, interrogez l’API Models pour obtenir les valeurs actuelles default_format et supported_formats du modèle :

curl "https://api.venice.ai/api/v1/models?type=tts" \
  -H "Authorization: Bearer $VENICE_API_KEY" |
  jq '.data[] | select(.id == "tts-kokoro") | .model_spec | {default_format, supported_formats}'

L’en-tête Content-Type de la réponse identifie le format audio retourné. Demander un format que le modèle sélectionné ne prend pas en charge renvoie un HTTP 400.

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

⌘I

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

Utilisation de base

Choisir un modèle et une voix

Forme de la requête

Format de sortie

Conseils pour la production

Ressources connexes

​Utilisation de base

​Choisir un modèle et une voix

​Forme de la requête

​Format de sortie

​Conseils pour la production

​Ressources connexes

Utilisation de base

Choisir un modèle et une voix

Forme de la requête

Format de sortie

Conseils pour la production

Ressources connexes