PalabraAI 设置教程

1选择凭据类型

先决定使用哪个控制台，然后只做接下来两步中的一步。初次使用 Palabra？请在 platform.palabra.ai/register 注册，并使用 Platform API Key（第 2 步）。已经有 App 签发的 Client ID 和 Client Secret？直接跳到第 3 步，无需新建任何东西。

2Platform：创建 API Key

访问 platform.palabra.ai/api-keys 并登录。新建一个密钥，起一个便于识别的名称，例如"Sokuji"。密钥仅在创建后显示一次——请立即复制并妥善保存；页面刷新后就无法再查看。如果丢失，请删除该密钥并重新创建。

3App：创建密钥并复制两个值

访问 app.palabra.ai/dev/api-keys 并登录。该页面位于 Palabra App 的 Developer 标签页下，路径为 Developer Tools → API Keys。点击 + Create API Key，起一个便于识别的名称，例如"Sokuji"，然后打开该密钥，同时复制两个值：Client ID 和 Client Secret。Client Secret 仅在创建时可复制一次，之后会被遮蔽且无法恢复。如果丢失，只能删除该密钥并重新创建。每个账户最多可持有 3 个密钥。

4检查您的额度余额

PalabraAI 是付费服务：如果账户额度耗尽，会话将无法启动或在中途中断。开始之前，请在创建凭据的那个控制台中查看额度余额和免费试用状态（在 App 中显示于侧边栏左下角以及 Usage 页面），确认您仍有可用额度。

5在 Sokuji 中配置

打开 Sokuji 并导航到设置面板。选择 "PalabraAI" 作为您的 AI 提供商。使用凭据输入框上方的切换开关，选择与凭据来源一致的模式：Platform API Key 只显示一个 API Key 输入框——把密钥粘贴进去；App Client ID/Secret 显示两个输入框——把 Client ID 和 Client Secret 分别粘贴到对应字段（请确认两者没有填反）。无论哪种模式，都请确认没有多余空格，点击验证确认凭据可用，然后选择语音设置（default_low 或 default_high），配置源语言和目标语言，再点击保存设置。

6测试您的设置

启动翻译会话以验证一切正常工作。点击开始会话按钮，对着麦克风说话，您应该能听到延迟最小的翻译音频输出。

WebRTC 技术

PalabraAI 使用 WebRTC 实现超低延迟流传输，非常适合实时对话。该服务自动处理：

• 音频压缩和传输
• 网络优化
• 自动质量调整
• 回声消除和降噪

语言支持

PalabraAI 支持广泛的语言组合：

• 60 多种源语言，包括主要世界语言和地区变体
• 40 多种目标语言，具有地区特异性（例如，墨西哥西班牙语与西班牙西班牙语）
• 针对常用语言对进行优化

自动处理

与其他提供商不同，PalabraAI 自动处理大多数音频处理：

• 无需手动配置轮次检测
• 自动音频质量优化
• 内置降噪
• 基于网络条件的自适应流传输

常见问题

认证错误: 请检查 Sokuji 中的模式开关是否与凭据来源一致：来自 platform.palabra.ai 的密钥应填入 Platform API Key 模式下的 API Key 字段；来自 app.palabra.ai 的 Client ID + Client Secret 应填入 App Client ID/Secret 模式。Sokuji 不会自动尝试另一种模式，因此把 Platform 密钥粘贴到 Client ID 字段（或反过来）一定会失败。如果您已没有该密钥或 Client Secret，请在控制台中删除并重新创建。

会话无法启动: 请先检查创建凭据的那个账户的额度余额和免费试用状态——余额耗尽是最常见的原因。然后确认您的防火墙/网络允许 WebRTC 连接。

连接问题: PalabraAI 使用 WebRTC，因此请确保您的防火墙/网络允许 WebRTC 连接。

音频质量问题: 根据您的网络条件尝试在 default_low 和 default_high 语音设置之间切换。

语言对不工作: 验证您选择的源语言和目标语言组合是否受支持。

网络要求

• 稳定的互联网连接（最低 1 Mbps 上传/下载）
• 低网络延迟（最好低于 100ms）
• WebRTC 兼容的网络配置
• 如果可能，避免使用 VPN 以获得最低延迟