Appearance
Grok API完整指南:申请流程+定价+代码示例【2026年10月最新】
最后更新:2026年10月14日 | 面向开发者的完整接入教程
想在自己的应用里集成Grok?用Grok API做自动化?
这篇文章从0开始,手把手教你申请、配置、调用Grok API,附完整代码示例。
一、Grok API是什么?
Grok API是xAI提供的开发者接口,让你能在自己的程序中调用Grok模型的能力。
与网页版/App版不同,API让你可以:
- 在自己的应用中集成Grok对话能力
- 批量处理文本(翻译、总结、分类)
- 构建自动化工作流
- 开发基于Grok的产品
重要:Grok API采用兼容OpenAI的接口格式,如果你用过OpenAI API,几乎可以无缝迁移。
二、Grok API申请流程
2.1 注册xAI开发者账号
- 访问 xAI 开发者平台(console.x.ai)
- 用你的X账号或邮箱登录
- 完成开发者信息填写
2.2 创建API Key
- 进入控制台 → API Keys
- 点击「Create API Key」
- 给Key命名(如"my-project")
- 立即复制保存(Key只显示一次)
安全提醒
API Key等同于你的账户密码,绝不要:
- 提交到公开的Git仓库
- 写死在前端代码里
- 分享给他人
建议用环境变量存储。
2.3 充值API额度
Grok API采用预付费模式,需要先充值才能调用。
国内开发者的支付难题:xAI API同样只接受海外信用卡,国内银行卡无法直接充值。
三、Grok API定价(2026年10月)
xAI API按token用量计费,输入和输出分开计价。
| 模型 | 输入价格(每百万token) | 输出价格(每百万token) | 适用场景 |
|---|---|---|---|
| grok-4 | $3.00 | $15.00 | 复杂推理、编程 |
| grok-4-fast | $0.50 | $2.00 | 日常任务、高并发 |
| grok-3 | $2.00 | $10.00 | 通用场景 |
| grok-3-mini | $0.30 | $0.50 | 简单任务、成本敏感 |
价格会随xAI政策调整,以官网实时报价为准。
成本估算示例
假设你做一个翻译应用:
- 每次翻译输入500 token,输出500 token
- 用 grok-4-fast 模型
- 单次成本:(500×$0.5 + 500×$2) / 1,000,000 = $0.00125(约人民币9厘)
- 1000次翻译 ≈ $1.25(约9元)
对于轻量应用,API成本非常低。
四、调用Grok API(代码示例)
4.1 Python示例
Grok API兼容OpenAI SDK,直接用openai库即可:
python
from openai import OpenAI
client = OpenAI(
api_key="你的_API_KEY",
base_url="https://api.x.ai/v1"
)
response = client.chat.completions.create(
model="grok-4",
messages=[
{"role": "system", "content": "你是一个专业的翻译助手"},
{"role": "user", "content": "把这句话翻译成英文:今天天气真好"}
]
)
print(response.choices[0].message.content)4.2 Node.js示例
javascript
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "你的_API_KEY",
baseURL: "https://api.x.ai/v1",
});
const response = await client.chat.completions.create({
model: "grok-4",
messages: [
{ role: "system", content: "你是一个专业的翻译助手" },
{ role: "user", content: "把这句话翻译成英文:今天天气真好" },
],
});
console.log(response.choices[0].message.content);4.3 cURL示例
bash
curl https://api.x.ai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer 你的_API_KEY" \
-d '{
"model": "grok-4",
"messages": [
{"role": "user", "content": "你好,Grok"}
]
}'五、常用参数说明
| 参数 | 说明 | 示例值 |
|---|---|---|
| model | 使用的模型 | grok-4 |
| messages | 对话历史 | 见上方示例 |
| temperature | 随机性(0-2) | 0.7 |
| max_tokens | 最大输出长度 | 2000 |
| stream | 是否流式输出 | true/false |
流式输出示例(Python)
python
stream = client.chat.completions.create(
model="grok-4",
messages=[{"role": "user", "content": "写一首关于秋天的诗"}],
stream=True
)
for chunk in stream:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")六、国内开发者常见问题
Q1:国内能直接调用Grok API吗?
API接口本身国内可以访问,但充值需要海外信用卡。可以通过代充解决充值问题。
Q2:API和SuperGrok订阅是一回事吗?
不是。SuperGrok是网页版/App版的会员订阅;API是开发者接口,单独计费。两者额度不通用。
Q3:API Key泄露了怎么办?
立即到控制台删除旧Key,创建新Key。已产生的费用需要自己承担,所以务必保管好。
Q4:有免费额度吗?
xAI有时会提供新用户试用额度,具体以注册时的政策为准。
七、总结
Grok API接入三步走:
- 注册 → console.x.ai 创建账号和API Key
- 充值 → 预付费模式,国内可通过代充解决
- 调用 → 兼容OpenAI SDK,代码几乎零改动
对于国内开发者,最大的门槛是充值的支付问题。如果你没有海外信用卡,代充是最便捷的方案。
相关阅读: