第 1 步:创建 xAI 账户
在 accounts.x.ai注册账户,然后充值信用额度即可开始使用 API。
第 2 步:生成 API Key
在 API Keys 页面创建 API Key,然后将其导出或设置为环境变量。
Bash
export XAI_API_KEY="your_api_key"或者将其添加到项目目录中的 .env 文件:
XAI_API_KEY=your_api_key第 3 步:安装 SDK
选择你的语言并安装 SDK:
Python (xAI SDK)
pip install xai-sdk第 4 步:发送第一个请求
向 Grok 4.5 发送一个编码提示,获取响应。这是驱动 Grok Build 智能体编码的同一模型, 现在在 API 上以早期访问方式提供:
cURL
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.5",
"input": "修复这个函数并解释 bug: function median(a){a.sort();return a[a.length/2]}"
}'如需多轮对话、推理和结构化输出,请参阅文本生成指南。如需智能体编码工作流,请参阅Grok Build 概览。
第 5 步:生成图像
使用 Imagine API 从文本提示生成图像:
Python
import os
import xai_sdk
client = xai_sdk.Client(api_key=os.getenv("XAI_API_KEY"))
response = client.image.sample(
prompt="一座未来主义的城市天际线在夕阳下",
model="grok-imagine-image-quality",
)
print(response.url)如需更高级的用例(如批量生成、宽高比控制和图像编辑),请查看图像生成指南。
接下来做什么
现在你已经发送了第一个请求,探索 Grok 还能做什么:
代码
使用 grok-4.5 进行智能体编码(API 和 CLI)
对话
多轮对话、推理、结构化输出和流式传输
图像
使用 Grok 模型生成、编辑和理解图像
视频
使用文本提示或参考图像创建、扩展和编辑视频
语音
构建具有语音到语音能力的实时语音智能体
工具
网络搜索、X 搜索、代码执行和函数调用