首页/开始使用/快速开始

快速开始

欢迎来到 xAI!本指南将带你从创建账户到发送第一个 API 请求。

第 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 还能做什么:

资源

  • 流式输出 — 实时流式传输响应
  • 文件与集合 — 上传文档并构建 RAG 管道
  • 工具 — 网络搜索、X 搜索、代码执行和函数调用
  • 模型 — 比较可用模型及其能力
  • 定价 — 工具、Batch API 和其他平台定价