Appeler l'API avec vos réglages actuels
Les extraits ci-dessous reflètent le texte et les réglages du Studio.
Endpoints
| POST | /v1/speech | Texte → audio. response=json|base64 pour du JSON avec minutage. |
| GET | /v1/speech?text=… | Idem, utilisable directement dans <audio src>. |
| POST | /v1/plan | Aperçu du découpage et durée estimée, sans synthèse. |
| POST | /v1/jobs | Synthèse asynchrone pour les textes longs. |
| GET | /v1/jobs/:id/events | Progression en direct (Server-Sent Events). |
| DELETE | /v1/jobs/:id | Annuler un job. |
| GET | /v1/audio/:id | Audio rendu (Range supporté, ?download=1). |
| GET | /v1/audio/:id/subtitles.srt|vtt | Sous-titres synchronisés. |
| GET | /v1/voices | Voix disponibles (?language=fr). |
| GET | /v1/health | État et capacités du serveur. |
Spécification complète : /openapi.json (importable dans Postman, Insomnia, Swagger…).
Paramètres
| Nom | Type | Défaut | Description |
|---|
Balises dans le texte
[pause] [pause 800ms] [pause 2s] | Silence explicite (1 s par défaut, 10 s max). |
[voice en-US] … [voice] | Change de voix pour un passage, puis revient à la voix principale. |
[slow] … [/slow] | Diction lente sur un passage. |
| Ligne vide | Nouveau paragraphe (pause de paragraphe). |
Erreurs
Toujours au format {"error":{"code","message","field?"}} avec un statut HTTP adapté
(400 paramètre invalide, 401 clé d'API, 404, 413 texte trop long, 429 débit, 502 moteur de synthèse).