跳转到内容

开通并配置 xAI API

最后核对:2026-09-20。 xAI 的模型、Team 权限、区域端点和价格会更新,请以 Console 和官方文档为准。

xAI Console 中的 API Key、余额和模型权限都属于当前 Team。注册、充值和创建 Key 时,要确认页面右上角选中的是同一个 Team。

打开 xAI Console 注册页,按页面提示注册并登录。

进入 Console 后先确认当前 Team。如果你加入了多个 Team,切换 Team 也会切换 API Key、余额和权限范围。

  1. 打开 Billing
  2. 在 API Spend Management 中购买 Prepaid Credits。
  3. 根据需要设置自动充值触发余额、充值金额和月度上限。

截至核对日期,单次自动充值最低为 5 美元。金额和规则可能调整,付款前以 Console 为准。预付余额用完且没有可用月结额度时,API 请求会被拒绝。

  1. 打开 API Keys
  2. 确认当前 Team 正确。
  3. 创建新 Key,并立即安全保存。
  4. Usage 查看后续费用与 Token 用量。

xAI Key 当前通常以 xai- 开头。不要公开或共享。

打开对应 Agent 的 配置 API → 添加服务商

字段 推荐值
服务商名称 xAI
API 类型 OpenAI Responses
Base URL https://api.x.ai/v1
API Key Console 创建的 xai-... Key
默认模型 grok-4.6,或当前 Team 有权使用的模型 ID
启用此服务商 开启

只有目标工具不支持 Responses 时,才改用 OpenAI Chat Completions。保存后选择 配置生效,再执行 重新检测

截至核对日期,xAI 官方对代码和一般对话优先推荐 grok-4.6。不同 Team、地区和账号可能看到不同模型,请在 Console Models 确认权限,并查看 官方模型列表

grok-4.6 当前上下文为 500K。每百万 Token 美元价格:

提示长度 输入 缓存输入 输出
少于 200K 2 0.50 6
达到 200K 4 1 12

实际价格以 xAI 官方价格页 为准。

Grok Build 第一次启动通常会打开浏览器完成 xAI 登录。没有浏览器或用于自动化时,也可以按 Grok Build 官方文档 使用 xAI API Key。

EasyAI 安装完成后,优先跟随 Grok Build 自己的登录提示;只有需要统一管理模型服务或使用 API 计费时,才在 EasyAI 配置 xAI Key。

401:没有提供 Key,或 Key 错误、已失效。

403:当前 Team 没有所需权限。联系 Team 管理员,并确认 Key 与模型属于同一 Team。

404:Base URL、接口路径或模型 ID 不正确。

422:字段格式或所选 API 类型不符合接口要求。

429:达到速率限制。到 Console 查看限制和用量,必要时申请提高。

服务异常时查看 xAI Status;详细排错见 xAI Debugging