API Reference

Gemini Live WebSocket

Gemini 原生双向 WebSocket 会话。支持文本、音频、图片和视频输入;模型以 AUDIO 返回,并可通过 outputAudioTranscription 获取同步文本。

GET https://api.tu-zi.com/v1beta/live?model={model}
预览指南

粘贴给 AI,帮助理解文档并完成接入。 仅包含文档与示例,不包含真实密钥。

预览指南

Gemini Live WebSocket

更新 · 审核信息

接口与鉴权

GET https://api.tu-zi.com/v1beta/live?model={model}

传输方式: websocket

使用模型调用 API Key。示例凭证为占位符,请从环境变量读取真实密钥。

Authorization: Bearer YOUR_API_KEY

最小请求示例

{
  "setup": {
    "model": "models/YOUR_MODEL",
    "generationConfig": {
      "responseModalities": [
        "AUDIO"
      ]
    }
  }
}

运行前准备

将 https://api.tu-zi.com 替换为本站地址(不要重复追加 /v1),YOUR_MODEL 替换为模型广场中的完整模型名。Python 示例需要先安装 requests;JavaScript 示例使用 Node.js 20+ 并保存为 .mjs 文件。WebSocket 示例按代码注释安装专用依赖。

先在本站令牌页面创建模型调用密钥,并设置 API_KEY 环境变量;cURL 中的 YOUR_API_KEY 需要替换。上传示例中的 input.png/input.wav 是本地文件,必须提前准备。

首次运行使用最小请求;成功后对照下方响应字段读取结果。异步接口返回任务 ID 后仍需查询,任务提交成功不代表生成已完成。

适用限制

本页是协议基础结构。模型可用参数、枚举、上限和异步行为以该模型“快速上手”为准;示例中的 YOUR_MODEL 必须替换。表中表单初始值不代表上游默认值。

查询参数

字段类型必填说明与约束
modelstring是当前模型标识。 示例: YOUR_MODEL

响应字段

字段类型说明与约束
setupCompleteobject握手完成事件。
serverContent.modelTurn.parts[]object模型音频或其他内容块。
serverContent.turnCompleteboolean本轮结束。

以下为示例响应,部分接口仅展示主要字段;可选字段不保证出现。

{
  "setupComplete": {}
}

流式响应

连接使用 wss,先发 setup,再发送 realtimeInput 或 clientContent。按服务端事件接收音频与转写,处理 turnComplete、interrupted 和错误。 示例等待 setupComplete 后只发送一次请求,以收到模型输出并出现 turnComplete 为完成;错误、超时、提前断开或 interrupted 均视为未完成,不能自动重提。

错误处理与重试

检查 HTTP 状态与该协议的错误对象;不要将不同协议的错误字段混用。401/403 检查凭证与权限,429 退避等待,5xx 检查网关或上游状态。错误正文可能含 error/message/code 等字段,以实际协议为准。

查询可采用有上限的指数退避;创建任务、生成内容、创建或删除密钥等操作不要盲目重试,以免重复计费或重复执行。