
GPT-Live-1 API Key 配置:官方入口 4 步与报错排查
接入 GPT-Live-1 实时语音,本质是在 OpenAI 官方平台 上创建并配置一枚 API Key:注册平台、进 API keys 页新建密钥、充值并设好用量告警、再把 Key 写进代码去连实时语音接口。全程只需 4 步,公开模型接口需最先拿到,别跳过平台入口直接搜中转站。本文按官方口径写完 key 配置全流程,并对齐你常见的几个卡点。
先说明一点:GPT-Live-1 是 OpenAI 新一代实时语音模型的命名,官方站点已明确可经 Agents SDK / Responses API 以 voice 方式接入。它的 API Key 配置与 OpenAI 全家模型同一套账号体系,本文按官方 Realtime / Responses 语音接口的真实配置路径来写,配置位置与鉴权方式完全一致。

GPT-Live-1 API Key 需要的 4 步配置
1. 注册并登录 OpenAI 平台
访问 platform.openai.com,用邮箱或 Google 账号注册,完成邮箱验证后进入控制台。没有账号就先建一个,这一步会把账号与结算体系绑定。
2. 打开 API keys 页,创建密钥
进入右上角个人头像下拉里的 API keys,点击「Create new secret key」,设置名称(建议写 gpt-live-1-voice 便于识别)和绑定的「项目(Project)」。生成后只显示这一次,务必当场复制保存,丢了无法找回,只能删掉重建。
3. 预充值并设置用量告警
在平台 Billing 里充值(信用卡或充值码)。实时语音按 token 计费,跑起来比文本快,建议先在 Limits 页设置月度用量告警,避免一觉醒来超额。
4. 把 Key 写进代码,走实时语音接口
在服务端把 Key 放进环境变量(Authorization: Bearer sk-...),再连实时语音端点。以 Python + WebSocket 为例:
import os, websocket, json
API_KEY = os.environ["OPENAI_API_KEY"] # 只放服务端,别进前端
ws = websocket.create_connection(
"wss://api.openai.com/v1/realtime?model=gpt-live-1",
header=[f"Authorization: Bearer {API_KEY}"]
)
# 建立会话、发送音频流、接收响应,参考官方 Realtime 文档

GPT-Live-1 实时语音接入选什么协议
- WebRTC:浏览器 / 移动端直连,延迟约 50-100 ms,最像打电话,最适合客户端语音助手。
- WebSocket:服务器到服务器,延迟约 100-300 ms,适合需要自己收音频流的批处理或后端。
- SIP:电话线路集成,接入客服语音坐席,复杂度最高。
开发客户端语音把 Key 藏服务端,由服务端用 WebSocket / WebRTC 中转,前端一律不放 Key,防泄漏。
GPT-Live-1 语音模型计费对照(看清再配)
实时语音按输出 token 计价,输入输出价格不同,下表基于已公开的实时语音 API 定价整理:
| 计费项 | 参考单价 | 说明 |
|---|---|---|
| 音频输入 | 约 $6 / 1M token | 指语音转成 token 的输入部分 |
| 音频输出 | 约 $80 / 1M token | 模型合成语音输出 |
具体价格随模型版本浮动,配置前以官方 pricing 页为准,价格可能随迭代调整。

常见报错速查:Key 配好还是连不上
| 报错现象 | 原因 | 解法 |
|---|---|---|
401 invalid api key |
Key 填错或过期 | 回 API keys 页重建,重新复制粘贴 |
429 rate limit |
没充钱 / 超额 | 查 Limits 配额并充值,参考免费与量级说明 |
403 project not found |
Key 绑的项目不对 | 回建 Key 时指定的 Project 下拉重新选 |
| 前端报 CORS 报错 | Key 写在前端被拒 | 把 Key 挪到服务端,配 WebSocket 中转,参考 CodeBuddy 的服务端配置思路 |
免费额度与落地参考
免费档 ChatGPT 用户默认用的是 GPT-Live-1 mini,想调 API 本体仍要先在平台充值。要不要一开始就付 full 版,可先看免费档能用到哪一步。想在公司内部把语音接入 Agent,建议把 Key 交给统一网关,参照 Windsurf 的服务端 Key 保管路径,别在各机器散放。
最后更新
2026 年 10 月:整合官方实时语音接口配置口径与计费对照。
作者:AI345
常见问题
GPT-Live-1 的 API Key 在哪创建?
答:登录 [platform.openai.com](https://platform.openai.com),进入个人头像下的 **API keys** 页,点 Create new secret key 即可,和建任意 OpenAI 模型 Key 是同一处入口。
Key 是免费的吗?不充值能不能调 GPT-Live-1?
答:建 Key 本身免费,但 GPT-Live-1 实时语音接口按 token 计费,真正调用需要先在 Billing 充值。免费体验请走 ChatGPT 里默认的 GPT-Live-1 mini;要调 API 本体得先充值并设用量告警。
GPT-Live-1 和 gpt-4o-realtime-preview 的 Key 通用吗?
答:通用。所有 OpenAI 模型的 Key 是同一套 API keys 体系,Key 只绑定项目(Project)、不限定模型。同一个 Key 既能连 gpt-4o-realtime,也能接入 GPT-Live-1 的实时语音接口。
为什么把 Key 写进前端会报 CORS 错误?
答:为了让 Key 不在浏览器落地、防泄漏,OpenAI 服务端会拒绝来自前端的直连调用。正确做法是 Key 放后端,用服务端代理或 WebSocket 中转,前端只跟自己的服务端通信。
国内服务器能配 GPT-Live-1 的 Key 吗?
答:国内的平台入口与计费对国内用户可用,但直连 `api.openai.com` 需要稳定的海外网络环境。若在内网部署,多用支持的区域代理或中转网关;只是想把 Key 配起来调试,本地加标识即可,如实测走不通要确认网络路径。

京ICP备2024094994号-29