Synthèse vocale

Soumettez le texte, la voix, le format de sortie et les autres paramètres. Le corps de la réponse contient de l’audio binaire. Le client doit enregistrer ou traiter le résultat selon le format de sortie demandé.

POST/v1/audio/speech

Convertissez le texte d’entrée en parole et recevez le résultat sous forme de contenu audio binaire.

Authentification

bearerAuth

AuthentificationBearer <token>

Utilisez Bearer your-api-key dans le Header Authorization.

Emplacement: header

Corps de requête

application/json

Paramètres de la requête de synthèse vocale.

Définitions TypeScript

Utilisez le type request body en TypeScript.

model*string

ID du modèle de synthèse vocale, par exemple tts-1 ou tts-1-hd. Les modèles réellement disponibles sont ceux de la liste renvoyée pour la clé API actuelle.

Longueur1 <= length

input*string

Texte à convertir en parole, limité à 4096 caractères.

Longueur1 <= length <= 4096

voice*string

Voix utilisée pour la synthèse vocale.

Valeurs autorisées

"alloy"
"ash"
"ballad"
"coral"
"echo"
"fable"
"nova"
"onyx"
"sage"
"shimmer"
"verse"
"marin"
"cedar"

instructions?string

Instructions concernant le ton, la manière de parler ou d’autres caractéristiques de la voix.

Longueurlength <= 4096

response_format?string

Format audio de sortie.

Valeur par défaut"mp3"

Valeurs autorisées

"mp3"
"opus"
"aac"
"flac"
"wav"
"pcm"

speed?number

Vitesse de synthèse vocale, comprise entre 0.25 et 4.0.

Plage0.25 <= value <= 4

Valeur par défaut1

stream_format?string

Format de réponse en streaming. audio renvoie un flux audio binaire ; sse renvoie des événements audio sémantiques.

Valeur par défaut"audio"

Valeurs autorisées

"audio"
"sse"

Corps de réponse

`application/json`

curl -X POST "https://example.com/v1/audio/speech" \  -H "Authorization: Bearer your-api-key" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "input": "Bonjour le monde !",    "voice": "alloy"  }' \  --output speech.mp3

Le corps de la réponse n’est pas du JSON. Enregistrez le contenu binaire dans un fichier audio correspondant au format de sortie demandé.

<binary audio data>

Authentification

Corps de requête

Corps de réponse

200application/octet-stream

400application/json

401application/json

403application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`