Gemini 3.8 Live — 实时语音
实时语音对话、官方价格与接入状态
Gemini 3.8 Live
截至 2026-11-12,APIMaster 尚未开放此模型的实时会话服务。当前上游 WebSocket 握手返回 403,网关原生 Live 转发与计费也尚未完成验收。价格已登记不代表服务可调用。
用途
支持文字、音频、图片和视频输入,以及文字和音频输出。适合语音客服、口语陪练和带视觉上下文的实时助手。Live 用于持续对话;配音和逐字朗读请使用 TTS 模型。
官方价格
下表是 Google Standard 官方基准价,核查于 2026-11-12;不代表 APIMaster 当前在售价格。
| 模态 | 美元 / 百万 tokens |
|---|---|
| 文本输入 | $0.75 |
| 文本输出(含思考) | $4.50 |
| 音频输入 | $3.00 |
| 音频输出 | $12.00 |
| 图片 / 视频输入 | $1.00 |
Google 直连参考示例
此示例连接 Google 官方服务,需要有 Live 权限的 Google API Key,不使用 APIMaster Key。它不是当前 APIMaster 接口的可用性承诺。
安装 SDK,并在服务器环境变量中设置 GEMINI_API_KEY 后运行。程序将一段简短语音保存为 reply.wav。
python -m pip install google-genai
python gemini_live_reference.py
import asyncio
import os
import wave
from google import genai
async def main():
client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
async with client.aio.live.connect(
model="gemini-3.8-live",
config={"response_modalities": ["AUDIO"]},
) as session:
await session.send_client_content(
turns={"role": "user", "parts": [{"text": "Say hello briefly."}]},
turn_complete=True,
)
audio = bytearray()
async for message in session.receive():
content = message.server_content
if content and content.model_turn:
for part in content.model_turn.parts or []:
if part.inline_data and part.inline_data.data:
audio.extend(part.inline_data.data)
if not audio:
raise RuntimeError("The Live session returned no audio")
with wave.open("reply.wav", "wb") as output:
output.setnchannels(1)
output.setsampwidth(2)
output.setframerate(24000)
output.writeframes(audio)
asyncio.run(main())
音频输入与输出
麦克风输入使用 16 kHz、单声道、16 位有符号小端 PCM;回复音频为 24 kHz PCM。发送音频时将数据转为 Base64,逐块发送以下消息;字段名保持原样。
{"realtimeInput":{"audio":{"mimeType":"audio/pcm;rate=16000","data":"BASE64_PCM16_AUDIO"}}}
会话与排错
使用 Live API WebSocket,等待 setupComplete 后再发送输入,收到 turnComplete 表示本轮结束。握手 403 表示连接未建立,不等于模型指纹不符。generateContent 或 Chat Completions 不能替代 Live 双向会话。正式接入需验证鉴权、音频收发、打断、工具调用、重连及按模态计费。密钥仅保存在服务端;不要写进网页或公开仓库。
来源与核查日期
2026-11-12 · Google: Gemini 3.8 Live · Google: Live API · Google: pricing
