「我买了 Grok 会员，为什么密钥用不了？」——这是接入咨询里最常见的一类问题。问的人默认「网页版能用，接口就能用」，但这两件事在账号体系、计费方式和能力范围上都不完全重叠。动手之前先把「你在调什么」分清，能省掉后面一半的困惑。

这一节不教写代码，只解决三件事：Grok API 是什么、它按什么计价、它和网页版差在哪。

一、问题不是「能不能调」，而是「你调的是哪个产品」

Grok 有两个面：面向普通用户的对话产品，和面向开发者的 API。它们共用一套账号体系，但计费是分开的：网页版走产品侧订阅，API 走控制台账单。所以「会员能不能调 API」这个问题，答案不是能或不能，而是「这是两笔账」。

按 2026-11-04 官方账号 FAQ，同一账号同时用于 Grok 与 API，但 API 账单在控制台管理，Grok 账单在产品设置或应用商店。这一条决定了后面所有成本讨论的前提：API 的钱，只能从 API 侧看。

至于四个域名各自管什么，第 1 章会逐项拆（见 1.1）。本节只记住一个：真正接收推理请求的是 api.x.ai。

二、能力域与计价单位不是一套

Grok API 不是一个「聊天接口」，而是几组能力，每组有自己的计价单位。把它们混成「一次请求多少钱」，是估算失真的起点。

能力域	代表接口或模型	计价单位
文本生成	grok-4.7 等语言模型	每百万 token（输入 / 缓存输入 / 输出）
图像理解	具备视觉输入的语言模型	随文本 token 计，单图有大小与格式限制
图像生成	grok-imagine-image-2.0 等	每张
视频生成	grok-imagine-video 系列	每秒
语音对话	grok-voice-3.0	每分钟，另计文本输入
语音转写	grok-voice-transcribe 系列	每小时（流式与非流式价不同）
文本转语音	TTS 接口	每百万字符
工具调用	内置搜索、代码解释器等	token 用量 + 调用次数

三件要强调的事：

• 只有文本那一条按 token 算。图像按张、视频按秒、语音按分钟、TTS 按字符；工具调用还要叠加次数。用「请求数 × 单价」估，注定只算到一部分（第 5 章会把这条账补全）。
• 文本内部还分档。prompt 达到某个阈值后，整个请求的所有 token 按高档计费——这是第 4 章的核心，也是账单失控最常见的单点原因。
• 单价与能力都会变。本节表格只标能力与计价单位，不给具体价格；价格以官方定价页与控制台当前显示为准（核验日期 2026-11-04）。

三、和 OpenAI SDK 的兼容边界

官方 Quickstart 同时给出 OpenAI SDK 与 xAI 自家 SDK 的写法，这意味着你可以用熟悉的 openai 包指向 api.x.ai。但「能复用 SDK」不等于「能复用旧代码」：

• 官方首请求示例走的是 client.responses.create(...)，入参是 input，取答案用 output_text。
• 旧教程里的 chat.completions.create 配 messages 是另一套写法，字段与取值路径都不同（见 2.1、3.1）。
• 两套写法混用最典型的后果不是报错，而是代码在错误的位置取答案，拿到空值。

所以兼容的正确理解是：SDK 可以复用，接口写法要按当前官方示例重写。

四、预期输出与异常分支

这一节没有代码，产出是三个能自答的判断。读完应能回答：

问题	能答上来的标志
API 和网页版差在哪	说得出「账号共用、计费分开」
我的场景会碰几条计费线	能列出文本 / 图像 / 语音里的具体项
旧代码能不能直接跑	知道要先确认是 Responses 还是 Chat Completions 写法

若这三问答不上来，先别急着申请密钥——大概率会在第一步就卡在「地址填错」或「字段取空」上（见 2.4 的排查树）。

五、判据卡

判断项	该这么做	不该这么做
要程序化接入	用 api.x.ai + 控制台密钥	把网页版对话当 API 用
只做对话体验	用网页版产品	为聊天场景申请 API
成本估算	按能力域分别列，再合计	用「请求数 × 单价」一句话带过
复用旧代码	先确认接口写法代际	直接改模型名就跑
找密钥与账单	控制台	在产品设置里找开发者密钥

这张卡的重点是先分清产品，再谈接入。五条里有四条都在回答同一个问题：你面对的是哪一套体系。

六、来源与核验

• 官方概览：https://docs.x.ai/overview（核验日期 2026-11-04）。站点定位与能力分组以该页为准。
• 官方模型页：https://docs.x.ai/developers/models（核验日期 2026-11-04）。在售模型、能力域与媒体价目单位以该页为准。
• 官方账号 FAQ：https://docs.x.ai/developers/faq/accounts（核验日期 2026-11-04）。同账号共用、API 与 Grok 计费分开的口径来自该页。
• 官方 Quickstart：https://docs.x.ai/developers/quickstart（核验日期 2026-11-04）。responses.create / input / output_text 的写法来自该页。
• 本节不给具体价格；价格、额度与区域可用性以官方定价页与控制台当前显示为准。

七、动手试

1. 列出你的场景会碰到的计费线：文本、图像、视频、语音、TTS、工具调用，各写一条「量级由什么参数决定」。
2. 判断你手上的三个需求，哪些该用 API、哪些用网页版就够。写出判断依据，而不是凭感觉。
3. 反向验证一次：写一句「我不需要 API 的理由」。如果写得很顺，说明你还没找到必须接入的那个点——这比急着申请密钥更有价值。