1. 文字转语音 Skyblight
MyVocal AI语音大模型API文档
  • 文字转语音大模型
    • 概览与快速开始
      • 模型介绍
      • 选择模型与接口
      • 支持语言
      • 音频格式与播放
      • 常见问题
      • SDK 与示例
    • 接口参考
      • HTTP 合成
        • HTTP 流式合成
        • HTTP 非流式合成
      • 音色管理
        • 创建声音
        • 获取声音列表
        • 删除声音
      • WebSocket 合成
        • 普通 TTS · 单连接
        • 普通 TTS · 多 Context
        • 多角色对话 · 多 Context
      • 用量与请求查询
        • 查询主key用量
        • Request_id客户端查询
        • 发音人用量查询
      • 子密钥管理
        • 创建子 Key
        • 查询子 Key 列表
        • 获取单个子 Key 详情
        • 更新子 Key
        • 查询子 Key 用量
  • 金融行业定制TTS模型
    • 文字转语音 Skyblight
      • 创建声音
        POST
      • 获取声音列表
        GET
      • 流式文字转语音
        POST
      • 非流式文字转语音
        POST
      • 删除声音
        DELETE
      • 用量查询
        GET
    • 全双工通信
      • websocket接入说明
      • V2 双向流式合成(WebSocket)
  • 语音转文字ASR
    • 概览与接入
      • 快速开始:文件转录
      • 快速开始:实时转录
      • 模型与能力
      • 更新记录
    • 接口参考
      • 实时转录
      • 创建文件转录
      • 查询用量
  • 企业客户声音定制服务
    • 定制属于你的专属声音
  1. 文字转语音 Skyblight

流式文字转语音

POST
https://openapi.myvocal.ai/v2/ai/speech/stream
边生成边返回音频,适合实时播放。
适用场景:电话客服、在线对话、语音导航、智能助手
Endpoint:POST https://openapi.myvocal.ai/v2/ai/speech/stream
模型、语言和格式选择:查看文字转语音总览

快速开始#

1.
在页面右侧选择需要的编程语言并复制请求示例。
2.
将 YOUR_API_KEY 和 <VOICE_ID> 替换为自己的值。
3.
根据业务需要修改文本、模型、语言和音频格式后发送请求。

成功响应#

HTTP 200,响应体是连续返回的音频二进制数据。收到第一批音频字节后即可开始播放,并持续读取直到响应结束。
不要把成功响应按 JSON 解析。 format 决定输出音频格式。

参数使用提示#

页面下方的参数表是本接口请求结构的权威说明。常用参数:
voice、text、model 为必填项。
language 建议明确传入;不传时服务会根据文本自动判断。
format 必须与所选模型支持的格式匹配。
sample_rate 单位为 Hz;电话场景使用 ulaw 时通常选择 8000。
seed 使用小写;相同文本和配置下,相同 seed 可提高多次生成结果的一致性。
priority 通常使用 auto。

常见错误#

HTTP 状态常见原因处理建议
400字段类型、模型、语言或音频格式不符合要求检查请求参数和模型能力表
401 / 403API Key 无效或当前账号无权限检查 API-Key Header 和账号权限
429请求频率或并发达到限制降低请求频率,稍后重试
5xx服务暂时不可用保留请求时间并稍后重试

相关文档#

文字转语音总览
获取声音列表
非流式文字转语音

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功:音频二进制
application/octet-stream
连续返回的音频二进制数据。收到音频字节后即可开始播放,持续读取直到响应结束;不要按 JSON 解析。
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://openapi.myvocal.ai/v2/ai/speech/stream' \
--header 'API-Key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "voice": "<VOICE_ID>",
  "text": "您好,这是一次流式语音测试。",
  "model": "Skyblight-Turbo",
  "language": "zh",
  "format": "mp3",
  "sample_rate": 24000,
  "priority": "auto"
}'
上一页
获取声音列表
下一页
非流式文字转语音
Built with