文档

API 参考

文本转语音

POST/v1/audio/speech

合成语音，成功返回模型相关音频二进制，默认格式由所选模型决定。启用文件归档时 X-Gloop-File-Id/X-Gloop-Storage-Status 等响应头说明保存阶段；不把音频当 JSON。

鉴权与权限

使用当前 GloopAPI Key。模型、功能与权限以当前 Key 的目录及接口说明为准。

Authorization: Bearer $GLOOP_API_KEY

鉴权方案： BearerAuth

请求

请求体 · application/json

类型
object
必填字段
modelinputvoice

请求体必填

  • modelstring必填
  • inputstring必填

    待合成文本；长度限制取决于所选模型，没有统一的 4096 字符上限。

  • voicestring必填

    具体支持与限制取所选模型，不保证统一默认值。

  • response_formatstring选填

    请求音频输出格式，支持值及省略时格式由所选模型决定；平台通用入口不赋予 mp3 默认。

  • speednumber选填

    具体支持与限制取所选模型，不保证统一默认值。

  • instructionsstring选填

    模型相关语音指导。

  • stream_formatstring选填

    模型相关流格式；不保证所有模型支持 SSE。

响应与错误

HTTP 200

成功生成音频

audio/mpeg

类型
string
格式
binary
说明
音频字节流，保存为文件。
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/wav

类型
string
格式
binary
说明
音频字节流，保存为文件。
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/ogg

类型
string
格式
binary
说明
音频字节流，保存为文件。
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/flac

类型
string
格式
binary
说明
音频字节流，保存为文件。
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/aac

类型
string
格式
binary
说明
音频字节流，保存为文件。
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

application/octet-stream

类型
string
格式
binary
说明
音频字节流，保存为文件。
{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

HTTP 401

Key 缺失、无效、过期或已撤销。

application/json

类型
object
必填字段
error

HTTP 403

IP、账户、模型或工具权限不足。

application/json

类型
object
必填字段
error

HTTP 429

请求/队列限流。

application/json

类型
object
必填字段
error

HTTP 500

鉴权或数据存储内部失败。

application/json

类型
object
必填字段
error