OpenAI 兼容 API 设置教程

1选择兼容的提供商

选择支持 OpenAI Realtime API WebSocket 协议的服务。重要提示：目前支持 Realtime API 的提供商非常少——大多数 OpenAI 兼容服务仅支持 Chat Completions API，这不足以使用 Sokuji。在继续之前，请务必确认您的提供商明确支持 Realtime API。

2获取 API 端点和密钥

从所选提供商获取 API 端点 URL 和 API 密钥。端点 URL 通常格式为 https://your-provider.com，自托管服务则为 http://localhost:8080。

3在 Sokuji 中选择 OpenAI 兼容 API

打开 Sokuji 并导航到设置面板。从提供商下拉菜单中选择 "OpenAI Compatible API" 作为 AI 提供商。

4输入配置信息

将自定义 API 端点 URL 粘贴到 "API Endpoint" 字段中。在 "API Key" 字段中输入 API 密钥。如果您的提供商不需要 API 密钥（例如本地服务），可以留空或输入占位符值。

5选择模型和语音

选择您的提供商支持的模型和语音设置。可用选项取决于您的特定提供商。常见模型包括 gpt-4o-realtime-preview 或提供商特定的模型名称。

6测试连接

启动翻译会话以验证一切正常工作。点击开始会话按钮，对着麦克风说话，检查连接是否成功建立以及音频是否正在翻译。

什么是 OpenAI 兼容 API？

OpenAI 兼容 API 是一个通用提供商选项，允许 Sokuji 连接到任何实现 OpenAI Realtime API 协议的服务：

• 使用自定义基础 URL 连接任何 OpenAI 兼容端点
• 支持云托管和自托管服务
• 灵活切换不同的后端提供商
• 适用于私有部署、成本优化或区域合规

关于提供商兼容性

大多数 OpenAI 兼容服务仅支持 Chat Completions API。Realtime API（基于 WebSocket，支持音频流）是不同的协议，支持它的提供商非常少：

• Azure OpenAI 服务：支持在 Microsoft Azure 上托管的 OpenAI 模型的 Realtime API
• 请务必查看提供商文档确认是否明确支持 Realtime API
• OpenRouter、Together AI 等服务通常不支持 Realtime API
• 部分代理服务（如 CometAPI）可能提供 Realtime API 兼容性——使用前请验证
• 自托管方案必须实现完整的 Realtime API WebSocket 协议

配置提示

• 端点 URL 不应包含尾部斜杠（例如，使用 https://api.example.com 而不是 https://api.example.com/）
• 对于本地服务，使用 http://localhost:<port> 作为端点
• 某些提供商可能需要特定的请求头或认证方式
• 如果使用代理服务，请确保正确转发 WebSocket 连接

常见问题

连接被拒绝: 验证端点 URL 是否正确以及服务是否正在运行。对于本地服务，检查服务器是否已启动并在预期端口上监听。

认证错误: 仔细检查您的 API 密钥。某些提供商需要特定的密钥格式。确保您的账户有权访问 Realtime API。

模型未找到: 模型名称可能与 OpenAI 的默认模型不同。请查看提供商文档以了解可用的模型名称。

WebSocket 连接失败: 确保您的提供商支持 Realtime API 的 WebSocket 连接。仅支持 HTTP 的标准端点（Chat Completions）将无法工作。

检查提供商兼容性

1. 验证您的提供商明确支持 OpenAI Realtime API 协议
2. 检查是否支持 WebSocket 连接（不仅仅是 REST API）
3. 确认提供商支持音频输入/输出流
4. 如果可能，直接使用 WebSocket 客户端测试端点 URL
5. 查看提供商文档中是否有特定的配置要求