Documentazione

Riferimento API

Sintesi vocale

POST/v1/audio/speech

Sintetizza la voce e restituisce dati audio binari secondo il modello; il formato predefinito dipende dal modello. Con archiviazione attiva, X-Gloop-File-Id/X-Gloop-Storage-Status e altri header descrivono il salvataggio. Non trattare l'audio come JSON.

Autenticazione e autorizzazioni

Usa la chiave GloopAPI corrente. Modelli, funzionalità e autorizzazioni disponibili dipendono dal relativo catalogo e dalla documentazione dell'endpoint.

Authorization: Bearer $GLOOP_API_KEY

Schemi di autenticazione: BearerAuth

Richiesta

Corpo della richiesta · application/json

Tipo
object
Campi obbligatori
modelinputvoice

Corpo della richiesta obbligatorio

  • modelstringObbligatorio
  • inputstringObbligatorio

    Testo da sintetizzare; i limiti di lunghezza dipendono dal modello scelto. Non esiste un limite generale di 4096 caratteri.

  • voicestringObbligatorio

    Supporto e limiti dipendono dal modello scelto; non sono garantiti valori predefiniti uniformi.

  • response_formatstringFacoltativo

    Formato audio richiesto; valori supportati e formato se omesso dipendono dal modello. L'interfaccia generica non imposta mp3 come predefinito.

  • speednumberFacoltativo

    Supporto e limiti dipendono dal modello scelto; non sono garantiti valori predefiniti uniformi.

  • instructionsstringFacoltativo

    Istruzioni vocali specifiche del modello.

  • stream_formatstringFacoltativo

    Formato del flusso secondo modello; SSE non è garantito per tutti i modelli.

Risposte ed errori

HTTP 200

Audio generato

audio/mpeg

Tipo
string
Formato
binary
Descrizione
Flusso di byte audio da salvare in un file.
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/wav

Tipo
string
Formato
binary
Descrizione
Flusso di byte audio da salvare in un file.
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/ogg

Tipo
string
Formato
binary
Descrizione
Flusso di byte audio da salvare in un file.
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/flac

Tipo
string
Formato
binary
Descrizione
Flusso di byte audio da salvare in un file.
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/aac

Tipo
string
Formato
binary
Descrizione
Flusso di byte audio da salvare in un file.
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

application/octet-stream

Tipo
string
Formato
binary
Descrizione
Flusso di byte audio da salvare in un file.
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

HTTP 401

Key assente, non valida, scaduta o revocata.

application/json

Tipo
object
Campi obbligatori
error

HTTP 403

Autorizzazioni IP, account, modello o strumento insufficienti.

application/json

Tipo
object
Campi obbligatori
error

HTTP 429

Limite di frequenza delle richieste/della coda.

application/json

Tipo
object
Campi obbligatori
error

HTTP 500

Errore interno di autenticazione o storage dei dati.

application/json

Tipo
object
Campi obbligatori
error