xAI API

xAI API 是 xAI 面向开发者提供的官方接口，可调用 Grok 系列模型完成对话、文本生成与推理任务。接口沿用 OpenAI 的形状，官方文档直接给出用 OpenAI SDK 改 Base URL 的接入示例。

这是什么

xAI API 是调用 Grok 系列模型的官方接口，面向需要把这些模型接进自有产品的开发者。它与 Grok 助手产品是两件事：产品面向使用者，API 面向程序，账单也各自独立。

最省事的一点：接口形状与 OpenAI 一致

这是它区别于其他官方接口的核心特征。官方文档的入门示例直接使用 OpenAI 的 Python SDK，只把 Base URL 指向自家地址：

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["XAI_API_KEY"],
    base_url="https://api.x.ai/v1",
)

对已经在用 OpenAI 接口的项目，这意味着迁移成本通常只有两行配置——前提是你早就把 Base URL 和密钥做成了配置项而不是硬编码。

需要提醒的是：接口形状一样，不等于能力一样。 形状相同只保证请求能发出去；具体支持哪些参数、哪些能力，仍要以 xAI 官方文档为准。真正依赖的功能应该逐项实测，方法见 OpenAI 兼容接口怎么判断。

认证与 Base URL

密钥以 Bearer 形式放在 Authorization 请求头里：

Authorization: Bearer $XAI_API_KEY

Base URL 是 https://api.x.ai/v1，文本生成走该前缀下的 responses 端点。官方示例使用 XAI_API_KEY 环境变量——沿用这个命名可以省掉团队内部的沟通成本。

密钥的保管规则与其他家没有区别：只放服务端、只走环境变量、前端与代码仓库里绝不出现。通用做法见 OpenAI API Key 获取与安全管理，其中的原则同样适用于这里。

能力范围

以 Grok 系列模型为核心，提供对话、文本生成与推理能力，并支持工具调用。

具体可用的模型型号更替较快，不建议在代码里写死模型名——把它做成配置项，换型号时不用改代码也不用重新发版。

计费方式

按 token 用量计费，输入与输出分别计价。具体单价与可能的额度政策以官方价格说明为准，本页不写死数字。

估算成本的可靠方式仍然是拿真实输入跑一轮，用接口返回的用量字段核对，而不是比较标价。

适合什么场景

• 想在自有产品里试用 Grok 系列模型，又不想为此重写调用层的团队；
• 已经用 OpenAI 接口形状搭好了服务、希望能低成本地并行接入多家模型的项目。

如果你的应用需要的是多模态、语音或向量能力，接入前先确认官方文档当前是否覆盖，不要按「和 OpenAI 一样」来假设。

接入前要确认什么

• Base URL 与密钥是不是配置项，而不是硬编码；
• 你实际用到的参数在官方文档里是否明确支持；
• 模型型号是否做成了配置，换型号时是否需要改代码；
• 限流与错误返回的具体形式是否已经实测过一轮。

官方接口之间的横向差异可以参考 OpenAI API vs Anthropic API；如果你在评估的是第三方中转而不是官方接口，先看 API 中转站是什么？和官方 API 有什么区别。