建立 2026-09-15 更新 2026-09-15

API 入門

xAI API 讓你在自己的服務裡呼叫 Grok。網址是 https://api.x.ai/v1。建議先讀 官方 Quickstart，本頁只留最小可用路徑。

四步開始

1. 在 console.x.ai 註冊並儲值
2. 建立 API 金鑰，設環境變數 XAI_API_KEY（不要把金鑰寫進 Git）
3. 安裝 SDK：pip install xai-sdk 或相容的 OpenAI SDK（記得改 base_url）
4. 對 Responses API 送第一個請求

聊天與寫程式，文件目前建議用 grok-4.6。生圖用 grok-imagine-image-2.0，生影片用 grok-imagine-video-1.5。完整價目與情境見 Models。

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.6",
    "input": "用台灣繁體中文解釋這段程式的 bug：function median(a){a.sort();return a[a.length/2]}"
  }'

Python（官方 xAI SDK）：

import os
from xai_sdk import Client
from xai_sdk.chat import user

client = Client(api_key=os.getenv("XAI_API_KEY"))
chat = client.chat.create(model="grok-4.6")
chat.append(user("用台灣繁體中文解釋這段程式的 bug：function median(a){a.sort();return a[a.length/2]}"))
print(chat.sample().content)

也可用 OpenAI SDK，把 base_url 設成 https://api.x.ai/v1，呼叫 responses.create。

選模型的最小原則

沒有啟用 Web Search／X Search 時，模型沒有即時新聞。要查現況就開伺服器端搜尋工具。

影片生成是非同步：送出後拿到 request_id，再輪詢直到完成。xAI SDK 的 client.video.generate(...) 會幫你輪詢。

下一步：函式呼叫見 Function calling；圖片見 Quickstart 第 5 步。