Documentation

Référence API

Synthèse vocale

POST/v1/audio/speech

Synthétise la voix et renvoie les octets audio selon le modèle ; le format par défaut dépend du modèle. Si l'archivage est activé, X-Gloop-File-Id/X-Gloop-Storage-Status et autres en-têtes décrivent la sauvegarde. Ne traitez pas l'audio comme du JSON.

Authentification et autorisations

Utilisez votre clé GloopAPI actuelle. Les modèles, capacités et autorisations disponibles dépendent de son catalogue et de la documentation du point de terminaison.

Authorization: Bearer $GLOOP_API_KEY

Schémas d'authentification : BearerAuth

Requête

Corps de requête · application/json

Type
object
Champs obligatoires
modelinputvoice

Corps de requête obligatoire

  • modelstringObligatoire
  • inputstringObligatoire

    Texte à synthétiser ; la longueur maximale dépend du modèle choisi. Aucune limite générale de 4096 caractères ne s'applique.

  • voicestringObligatoire

    La prise en charge et les limites dépendent du modèle choisi ; aucune valeur par défaut uniforme n'est garantie.

  • response_formatstringFacultatif

    Format audio demandé ; valeurs prises en charge et format si omis dépendent du modèle. L'interface générique ne définit pas mp3 par défaut.

  • speednumberFacultatif

    La prise en charge et les limites dépendent du modèle choisi ; aucune valeur par défaut uniforme n'est garantie.

  • instructionsstringFacultatif

    Instructions vocales propres au modèle.

  • stream_formatstringFacultatif

    Format de flux selon le modèle ; SSE n'est pas garanti pour tous les modèles.

Réponses et erreurs

HTTP 200

Audio généré

audio/mpeg

Type
string
Format
binary
Description
Flux d'octets audio à enregistrer dans un fichier.
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/wav

Type
string
Format
binary
Description
Flux d'octets audio à enregistrer dans un fichier.
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/ogg

Type
string
Format
binary
Description
Flux d'octets audio à enregistrer dans un fichier.
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/flac

Type
string
Format
binary
Description
Flux d'octets audio à enregistrer dans un fichier.
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/aac

Type
string
Format
binary
Description
Flux d'octets audio à enregistrer dans un fichier.
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

application/octet-stream

Type
string
Format
binary
Description
Flux d'octets audio à enregistrer dans un fichier.
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

HTTP 401

Key absente, invalide, expirée ou révoquée.

application/json

Type
object
Champs obligatoires
error

HTTP 403

Autorisations IP, compte, modèle ou outil insuffisantes.

application/json

Type
object
Champs obligatoires
error

HTTP 429

Limitation de débit des requêtes/de la file.

application/json

Type
object
Champs obligatoires
error

HTTP 500

Défaillance interne d'authentification ou de stockage des données.

application/json

Type
object
Champs obligatoires
error