Documentación

Referencia de API

Texto a voz

POST/v1/audio/speech

Sintetiza voz y devuelve audio binario según modelo. El modelo define el formato predeterminado. Con archivado activado, encabezados como X-Gloop-File-Id/X-Gloop-Storage-Status describen el guardado; no trates el audio como JSON.

Autenticación y permisos

Usa tu clave actual de GloopAPI. Los modelos, capacidades y permisos dependen de su catálogo y de la documentación del endpoint.

Authorization: Bearer $GLOOP_API_KEY

Esquemas de autenticación: BearerAuth

Solicitud

Cuerpo de solicitud · application/json

Tipo
object
Campos obligatorios
modelinputvoice

Cuerpo de solicitud obligatorio

  • modelstringObligatorio
  • inputstringObligatorio

    Texto que se sintetizará; los límites de longitud dependen del modelo elegido. No existe un límite general de 4096 caracteres.

  • voicestringObligatorio

    El soporte y los límites dependen del modelo elegido; no se garantizan valores predeterminados uniformes.

  • response_formatstringOpcional

    Formato de audio solicitado; valores y formato por omisión según modelo. El endpoint general no fija mp3 por defecto.

  • speednumberOpcional

    El soporte y los límites dependen del modelo elegido; no se garantizan valores predeterminados uniformes.

  • instructionsstringOpcional

    Instrucciones de voz según modelo.

  • stream_formatstringOpcional

    Formato de streaming según modelo; no se garantiza SSE en todos.

Respuestas y errores

HTTP 200

Audio generado correctamente

audio/mpeg

Tipo
string
Formato
binary
Descripción
Flujo de bytes de audio; guárdalo como archivo.
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/wav

Tipo
string
Formato
binary
Descripción
Flujo de bytes de audio; guárdalo como archivo.
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/ogg

Tipo
string
Formato
binary
Descripción
Flujo de bytes de audio; guárdalo como archivo.
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/flac

Tipo
string
Formato
binary
Descripción
Flujo de bytes de audio; guárdalo como archivo.
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/aac

Tipo
string
Formato
binary
Descripción
Flujo de bytes de audio; guárdalo como archivo.
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

application/octet-stream

Tipo
string
Formato
binary
Descripción
Flujo de bytes de audio; guárdalo como archivo.
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

HTTP 401

La clave falta, no es válida, caducó o fue revocada.

application/json

Tipo
object
Campos obligatorios
error

HTTP 403

Permisos insuficientes de IP, cuenta, modelo o herramienta.

application/json

Tipo
object
Campos obligatorios
error

HTTP 429

Límite de solicitudes/cola.

application/json

Tipo
object
Campos obligatorios
error

HTTP 500

Fallo interno de autenticación o almacenamiento de datos.

application/json

Tipo
object
Campos obligatorios
error