API Reference
同声传译 WebSocket
使用 Protobuf 二进制帧进行同声传译。
预览指南
粘贴给 AI,帮助理解文档并完成接入。 仅包含文档与示例,不包含真实密钥。
更新 · 审核信息
接口与鉴权
GET https://api.tu-zi.com/v1/realtime?model={model}
传输方式: websocket
使用模型调用 API Key。示例凭证为占位符,请从环境变量读取真实密钥。
Authorization: Bearer YOUR_API_KEY
调用准备
- 示例使用本站地址;调用其他站点时,仅替换站点地址,保留完整接口路径。
- 将
YOUR_MODEL替换为模型广场中的完整模型名。 - 使用本站令牌页面创建的模型调用密钥。按示例设置环境变量
API_KEY,或替换YOUR_API_KEY占位符。 - 准备本地文件
input.wav,或将示例中的文件路径替换为实际路径。
适用限制
本页是协议基础结构。模型可用参数、枚举、上限和异步行为以该模型“快速上手”为准;示例中的 YOUR_MODEL 必须替换。表中表单初始值不代表上游默认值。
最小请求示例
{
"request_meta": {
"session_id": "YOUR_SESSION_UUID"
},
"event": 100,
"source_audio": {
"format": "wav",
"rate": 16000,
"bits": 16,
"channel": 1
},
"request": {
"mode": "s2t",
"source_language": "zh",
"target_language": "en"
}
}
查询参数
| 字段 | 类型 | 必填 | 说明与约束 |
|---|---|---|---|
| model | string | 是 | 精确模型名,通过 URL 查询参数传入。 |
请求体参数
| 字段 | 类型 | 必填 | 说明与约束 |
|---|---|---|---|
| request_meta.session_id | string | 是 | 会话 UUID。 |
| event | integer | 是 | 按 AST 协议发送会话事件;100 为开始。 |
| source_audio | object | 是 | 输入音频格式配置,16 kHz、单声道、16-bit PCM。 |
| request | object | 是 | 模式 s2t/s2s 和源、目标语言。 |
响应字段
| 字段 | 类型 | 说明与约束 |
|---|---|---|
| event | integer | AST 响应事件类型。 |
| text | string | 字幕内容(按事件提供)。 |
| data | binary | 音频数据(按事件提供)。 |
流式响应
示例 JSON 表示 Protobuf 消息内容,不能直接把 JSON 文本发送到 WebSocket。需要官方 AST .proto 生成的客户端;参考模型快速上手的 Python 完整示例。
错误处理与重试
检查 HTTP 状态与该协议的错误对象;不要将不同协议的错误字段混用。401/403 检查凭证与权限,429 退避等待,5xx 检查网关或上游状态。错误正文可能含 error/message/code 等字段,以实际协议为准。
查询可采用有上限的指数退避;创建任务、生成内容、创建或删除密钥等操作不要盲目重试,以免重复计费或重复执行。
兔子API