词元广场TOKPUB.COM - 欢迎您，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
"xAI Grok OAuth（SuperGrok / X Premium+）"
xAI Grok OAuth（SuperGrok / X Premium+）
XAI_API_KEY——登录一次后，Hermes 会在后台自动刷新会话。codex_responses 适配器（xAI 暴露了 Responses 风格的端点），因此推理、工具调用、流式传输和 prompt（提示词）缓存无需任何适配器改动即可正常工作。概览
| 项目 | 值 |
|---|---|
| Provider ID | xai-oauth |
| 显示名称 | xAI Grok OAuth (SuperGrok / X Premium+) |
| 认证类型 | 浏览器 OAuth 2.0 PKCE（回环回调） |
| 传输层 | xAI Responses API（codex_responses） |
| 默认模型 | grok-4.3 |
| 端点 | https://api.x.ai/v1 |
| 认证服务器 | https://accounts.x.ai |
| 需要环境变量 | 否（此 provider 不使用 XAI_API_KEY） |
| 订阅要求 | SuperGrok 或 X Premium+——见下方说明 |
前提条件
--no-browser）xAI 可能按套餐限制 OAuth API 访问
HTTP 403（见 issue #26847）。如果浏览器中 OAuth 登录成功但推理返回 403，请设置 XAI_API_KEY 并切换到 API 密钥路径（provider: xai）——该接口目前不受相同限制。快速开始
~/.hermes/auth.json 中，并在过期前自动刷新。手动登录
远程 / 无头会话
127.0.0.1:56121 上运行。xAI 的重定向需要到达该监听器，因此在你的笔记本上打开 URL 会失败（Could not establish connection. We couldn't reach your app.），除非你转发端口：-J jump-user@jump-host。仅限浏览器的远程环境（Cloud Shell、Codespaces、EC2 Instance Connect）
ssh -L 方案不可用。请改用 --manual-paste——Hermes 跳过回环监听器，让你直接从浏览器粘贴失败的回调 URL：登录流程说明
1.
accounts.x.ai。2.
3.
~/.hermes/auth.json。4.
hermes auth remove xai-oauth 或在 xAI 账号设置中撤销访问。检查登录状态
◆ Auth Providers 部分将显示每个 provider 的当前状态，包括 xai-oauth。切换模型
配置参考
~/.hermes/config.yaml 将包含：Provider 别名
xai-oauth：直连 xAI 工具（TTS / 图像 / 视频 / 转录 / X 搜索）
XAI_API_KEY，选择器会提供三选一菜单：OAuth 登录、粘贴 API 密钥或跳过。视频生成默认关闭
video_gen 工具集默认禁用。在 hermes tools → 🎬 Video Generation（按空格键）中启用后，agent 才能调用 video_generate。否则 agent 可能回退到内置的 ComfyUI 技能，该技能同样标记为视频生成。配置 xAI 凭据后 X 搜索自动启用
XAI_API_KEY），x_search 工具集就会自动启用。如不需要，请通过 hermes tools → 🐦 X (Twitter) Search（按空格键）显式禁用。该工具通过 xAI 内置的 x_search Responses API 路由——支持 SuperGrok / X Premium+ OAuth 登录或付费 XAI_API_KEY，两者同时配置时优先使用 OAuth（消耗订阅配额而非 API 费用）。未配置任何 xAI 凭据时，无论工具集是否启用，工具 schema 都对模型隐藏。模型
| 工具 | 模型 | 说明 |
|---|---|---|
| 对话 | grok-4.3 | 默认；通过 OAuth 登录时自动选择 |
| 对话 | grok-4.20-0309-reasoning | 推理变体 |
| 对话 | grok-4.20-0309-non-reasoning | 非推理变体 |
| 对话 | grok-4.20-multi-agent-0309 | 多 agent 变体 |
| 图像 | grok-imagine-image | 默认；约 5–10 秒 |
| 图像 | grok-imagine-image-quality | 更高保真度；约 10–20 秒 |
| 视频 | grok-imagine-video | 文本转视频和图像转视频；最多 7 张参考图像 |
| TTS | （默认音色） | xAI /v1/tts 端点 |
models.dev 缓存实时获取；缓存刷新后，新的 xAI 模型会自动出现。grok-4.3 始终固定在列表顶部。环境变量
| 变量 | 作用 |
|---|---|
XAI_BASE_URL | 覆盖默认的 https://api.x.ai/v1 端点（极少需要）。 |
config.yaml 中设置 model.provider: xai-oauth（使用 hermes setup 进行引导配置），或在单次调用时传入 --provider xai-oauth。故障排查
Token 过期——未自动重新登录
invalid_grant 失败（刷新 token 被撤销或账号已轮换），Hermes 会显示类型化的重新认证消息，而不是崩溃。invalid_grant、授权被撤销等），Hermes 将刷新 token 标记为失效并在本地隔离——后续调用跳过注定失败的刷新尝试，而不是反复重放同一个 401。agent 显示一条"需要重新认证"消息，并在你再次登录前保持等待。hermes auth add xai-oauth 开始全新登录。下次成功交换后隔离状态自动清除。授权超时
hermes auth add xai-oauth（或 hermes model）。流程重新开始。State 不匹配（可能的 CSRF）
state 值与发送的不匹配。从远程服务器登录
127.0.0.1:56121——你笔记本上的浏览器无法访问它，除非进行 SSH 本地端口转发：登录成功后 HTTP 403（套餐 / 权限问题）
HTTP 403，消息类似于 "The caller does not have permission to execute the specified operation"。hermes model 不会改变结果。xAI 的后端已被观察到将 OAuth API 访问限制在特定 SuperGrok 套餐，即使应用内订阅处于激活状态（issue #26847）。XAI_API_KEY 并切换到 API 密钥路径：运行时出现"No xAI credentials found"错误
xai-oauth 条目，也未设置 XAI_API_KEY。你尚未登录，或凭据文件已被删除。hermes model 并选择 xAI Grok OAuth provider，或运行 hermes auth add xai-oauth。退出登录
auth.json 中的单例 OAuth 条目以及 xai-oauth 的所有凭据池行。如果只想删除单个池条目，请使用 hermes auth remove xai-oauth <index|id|label>（运行 hermes auth list xai-oauth 查看列表）。