Referência da API

Texto para voz

POST/v1/audio/speech

Sintetiza voz e retorna áudio binário conforme o modelo. O modelo define o formato padrão. Com arquivamento ativado, cabeçalhos como X-Gloop-File-Id/X-Gloop-Storage-Status descrevem o salvamento; não trate áudio como JSON.

Autenticação e permissões

Use sua chave atual do GloopAPI. Modelos, recursos e permissões disponíveis dependem do catálogo da chave e da documentação do endpoint.

Authorization: Bearer $GLOOP_API_KEY

Esquemas de autenticação: BearerAuth

Solicitação

Corpo da solicitação · application/json

Tipo: object
Campos obrigatórios: modelinputvoice

Corpo da solicitação obrigatório

modelstringObrigatório
inputstringObrigatório
Texto a sintetizar; os limites de comprimento dependem do modelo escolhido. Não há limite geral de 4096 caracteres.
voicestringObrigatório
O suporte e os limites dependem do modelo escolhido; não há garantia de valores padrão uniformes.
response_formatstringOpcional
Formato de áudio solicitado; valores e formato por omissão conforme modelo. O endpoint geral não fixa mp3 como padrão.
speednumberOpcional
O suporte e os limites dependem do modelo escolhido; não há garantia de valores padrão uniformes.
instructionsstringOpcional
Instruções de voz conforme modelo.
stream_formatstringOpcional
Formato de streaming conforme modelo; SSE não é garantido em todos.

Respostas e erros

HTTP 200

Áudio gerado com sucesso

audio/mpeg

Tipo: string
Formato: binary
Descrição: Fluxo de bytes de áudio; salve como arquivo.

{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/wav

Tipo: string
Formato: binary
Descrição: Fluxo de bytes de áudio; salve como arquivo.

{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/ogg

Tipo: string
Formato: binary
Descrição: Fluxo de bytes de áudio; salve como arquivo.

{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/flac

Tipo: string
Formato: binary
Descrição: Fluxo de bytes de áudio; salve como arquivo.

{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/aac

Tipo: string
Formato: binary
Descrição: Fluxo de bytes de áudio; salve como arquivo.

{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

application/octet-stream

Tipo: string
Formato: binary
Descrição: Fluxo de bytes de áudio; salve como arquivo.

{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

HTTP 401

A chave está ausente, inválida, expirada ou revogada.

application/json

Tipo: object
Campos obrigatórios: error

errorobjectObrigatório
Campos filhos de error (4)
- codestringOpcional
- messagestringOpcional
- typestringOpcional
- request_idstringOpcional

HTTP 403

Permissões insuficientes de IP, conta, modelo ou ferramenta.

application/json

Tipo: object
Campos obrigatórios: error

errorobjectObrigatório
Campos filhos de error (4)
- codestringOpcional
- messagestringOpcional
- typestringOpcional
- request_idstringOpcional

HTTP 429

Limite de solicitações/fila.

application/json

Tipo: object
Campos obrigatórios: error

errorobjectObrigatório
Campos filhos de error (4)
- codestringOpcional
- messagestringOpcional
- typestringOpcional
- request_idstringOpcional

HTTP 500

Falha interna de autenticação ou armazenamento de dados.

application/json

Tipo: object
Campos obrigatórios: error

errorobjectObrigatório
Campos filhos de error (4)
- codestringOpcional
- messagestringOpcional
- typestringOpcional
- request_idstringOpcional