Grok 完整指南：從方案、模型與 Imagine 到 xAI API 與隱私設定

這份指南怎麼讀

這是一份持續更新的參考文件，不是一次性的教學文章。內容的查詢日期是 2026-11-06，事實以 xAI（官方文件現稱 SpaceXSI）的官方頁面為準，包括 x.ai、grok.com、docs.x.ai，以及 X 的說明中心與 App Store、Google Play 的商店頁。官方查不到、或官方頁面彼此不一致的地方，本指南會直接寫「官方未公布」或「官方頁面不一致」，不用第三方的數字補。

Grok 在 2026 年被整個重新包裝過：公司歸屬、訂閱方案、模式選單、用量計算方式都變了。如果你對 Grok 的印象還停在 2025 年的 SuperGrok、DeepSearch、Think 按鈕，多半已經對不上，請先看下面的對照表。

Grok 是什麼

Grok 是 xAI 開發的 AI 助理與模型家族。使用者端的入口包括 grok.com、iOS 與 Android app，以及 X（原 Twitter）內建的 Grok；開發者端另有 API 與 Grok Build 等工具。官方介紹的主要特色是：

• 對話時可以搜尋網路與公開的 X 貼文，並附上引用。
• 同一個 app 內整合語音、圖片與影片生成（Grok Imagine）、檔案上傳、Connectors、Skills、Automations 與 Build。
• 付費方案把 Grok、Grok Bot、Cursor 與 X Premium 綁在同一張訂閱裡（第 3 章）。

xAI、SpaceX、X 的關係

這一段只寫官方頁面能驗證的部分：

官方自己的命名也不統一：網站頁尾寫 © 2026 SpaceX Super Intelligence LLC，Terms 與 AUP 以 SpaceXSI 自稱，但 App Store 的版權列仍是 © xAI Inc.，開發者欄顯示 X Corp.。本指南第一次提到公司時寫「xAI（官方文件現稱 SpaceXSI）」，之後用「xAI」指公司、「Grok」指產品。

Grok 與 Groq 不同

Grok 是 xAI 的聊天機器人與模型，網址 grok.com。Groq（拼法差一個 o）是另一家公司 Groq Inc.，做的是 LPU 推論晶片與雲端推論服務，跟 xAI 沒有關係。兩者名字很像，搜尋、買訂閱、串 API 時請認清網域：

本指南只談前者。

這一年的重大變動

下表對照 2025 年常見的認知與查詢日的官方現況：

怎麼讀這份指南

建議的順序：

1. 先讀本章與第 2 章，確認自己的入口與登入方式。
2. 第 3、4 章搞清楚方案、用量，以及 app 內的模式與模型名稱。
3. 日常對話、Imagine、工作流程（Connectors、Skills、Automations、Build）、Grok Bot 各有獨立章節。
4. 隱私與資料控制，建議每個人都讀，尤其是「Improve the model」開關與 Private Chat。
5. 開發者看 API 與 Grok Build 相關章節。

每章結尾都有資料來源與查詢日期。看到數字或名稱跟你在介面上看到的不同，以介面和官方頁面為準，這也是本指南需要持續更新的原因。

最容易過時的項目

下列項目在一兩個月內就可能變動，動手前請回官方頁面再確認：

價格的提醒：美元價格取自官方頁面；新台幣價格是 grok.com/plans 在查詢日以台灣顯示的參考價，促銷與 App 內購價格可能不同，細節見第 3 章。

資料來源：xAI joins SpaceX、Terms of Service、Privacy Policy、Consumer FAQs、X Subscription 公告、Grok 4.5 everywhere、Grok 4.7、Grok Automations、Introducing Grok Bot、Grok Connectors、Grok Skills、Grok Imagine Image 2.0、Grok Imagine Video 1.5、Grok FAQ、About Grok（X 說明中心）（2026-11-06 查詢）

入口、安裝與登入

Grok 的入口不只一個：網頁、手機 app、X 內建的 Grok 是三個最常用的，另外還有 Grok Bot、Grok Build、Office add-in 等延伸入口。先認清自己要用哪一個，因為不同入口適用的隱私政策、方案與功能並不完全相同。

入口一覽

官方還提到 Grok Voice 3.0 驅動 Tesla 車內的語音對話，以及 OpenClaw、OpenCode、Kilo Code、Warp、Hermes Agent 等第三方工具可以用 SuperGrok 或 X Premium 訂閱登入，這兩類偏向車用與開發者情境，不在本章範圍。

網頁版：grok.com

直接開 grok.com 即可使用。幾個要點：

• 未登入可以聊。首頁橫幅寫明這類對話不會出現在歷史紀錄，也不會用來訓練模型。官方的消費者 FAQ 對未登入使用的描述則是「可能匿名收集與保留」，且多數地區（歐盟與英國除外）無法選擇退出訓練，兩處說法不一致，隱私需求高的人請先讀隱私與資料章節，並以登入後的設定為準。
• 輸入框的模式選單（Fast、Auto、Expert、Heavy）未登入就看得到，另有一個需要登入的「Premium」項目。模式的意義見第 4 章。
• 網域請認準 grok.com。官方 FAQ 提到用錯網域（例如 grok.x.ai）會缺少 Projects 等功能。

手機 app

兩邊的商店頁標示並不一致：App Store 的版權列是 © xAI Inc.、開發者欄顯示 X Corp.，Google Play 的開發者欄則顯示 SpaceX Super Intelligence。這是官方命名還在過渡的結果，下載時以商店名稱「Grok」與上表的識別資訊核對即可。

另外，官方 x.ai/grok 的行銷頁寫「30+ languages」，與 App Store 標示的語言數不同；實際可用的語言以介面與對話為準，不建議當成保證。

X 內的 Grok

在 X 的導覽列點 Grok 圖示即可使用，網址是 x.com/i/grok。官方 X 說明中心寫明「Grok is available in all countries where X is available」，2026-07-22 發表的 Grok 4.5 也同步上線 X。X 訂閱者在 X 上有 Grok 分頁。

兩個容易搞混的地方：

• 適用的規則不同：在 X 上用 Grok，適用 X 的隱私政策與條款；grok.com 與 app 適用 SpaceXSI 的。訓練資料的關閉路徑也不同，見隱私與資料章節。
• X 說明中心的 About Grok 頁沒有標日期，內容仍以 xAI 稱呼，可能不是最新版本。

登入方式

官方 FAQ 列出 grok.com 可用下列方式登入：

連結 X 帳號的路徑：Settings → Account → Connect your X Account。如果你的 Grok 權益來自 X 訂閱（The X Subscription 或舊的 X Premium），建議連結同一個 X 帳號，讓訂閱狀態同步。

登入時請留意：

• 官方頁面沒有說明不同登入方式之間的帳號合併規則，建議固定用同一種方式登入，以免對話紀錄與訂閱分散。
• 訂閱要在你購買的平台管理：網頁買的在網頁管理，Apple 或 Google Play 買的到商店取消。
• 最低年齡是 13 歲（或所在國的法定最低年齡），13 至 17 歲需父母或監護人同意。

台灣能不能用

官方沒有公開一份完整的「不支援地區」清單可以引用。以下三項是查詢日能直接驗證的證據：

1. grok.com/plans 在台灣網路環境以 NT$ 標價，表示頁面把台灣視為可購買地區（價格見第 3 章）。
2. 台灣 App Store 有上架 Grok，中文名稱為「Grok - AI 助理」。
3. X 說明中心寫明 Grok 在所有 X 可用的國家都有。

官方 AUP 只寫「不得在我們不提供服務的地區提供本服務」，Terms 另有制裁地區條款，完整的地區名單官方未公布。

使用上的提醒：

• 台灣的 NT$ 價格與促銷是依連線地區顯示的。換用 VPN 或海外網路，頁面可能改成其他幣別。
• 不同地區的功能開放時間可能不一致。例如 Imagine 的參考圖與聲音參考一開始只在美國、特定方案提供，數日內才推到所有層級。
• 澳洲有額外條款（年齡保證與特定內容限制），詳見隱私與資料章節。

資料來源：Grok FAQ、Grok on the App Store（US）、Grok - AI 助理（台灣 App Store）、Grok on Google Play、About Grok（X 說明中心）、Grok 4.5 everywhere、Introducing Grok Bot、Grok Build for everyone、Terms of Service、Acceptable Use Policy、grok.com/plans、Grokipedia（2026-11-06 查詢）

方案與價格

2026-10-12 起，Grok 的新訂戶一律走 The X Subscription：把 Grok、Grok Bot、Cursor 與 X Premium 綁成一張訂閱，分成 Free、Plus、Premium、Super、Ultra 五檔。舊的 SuperGrok 與 X Premium 仍可續用，但切換到新方案是選擇性且不可逆的。先確認自己是哪一世代的方案，後面的用量規則才對得起來。

美元定價

幾個細節：

• 價格不含稅（例如 VAT）。
• 可隨時取消，需在續訂前至少 24 小時。
• 官方說 Premium 相當於原本 SuperGrok、Cursor Pro 與 X Premium+ 合計 $90／月 的內容。
• 官方的建議：新手從 Premium 開始，每天使用 agent 的人選 Super，重度使用選 Ultra；Plus 給用量較少的社群創作者。
• 「Grok API access」寫在 Plus 以上，但官方 FAQ 說 API 用量另按標準費率計費，不吃方案的用量池。API 計價見後面的 API 章節。
• Cursor 裡使用的第三方模型（例如 Claude、GPT）不含在方案內，按 API 牌價另計。

團隊與企業

Teams 與 Grok Business 在官方頁面是分開描述的，兩者的差異與是否同一產品線，官方頁面未說明，請依需求分別看 x.ai/pricing 與 x.ai/grok/business。

台灣顯示的參考價

下表是 grok.com/plans 在 2026-11-06 以台灣地區顯示的價格。NT$ 是參考價：官方頁面標示「不含稅或其他費用」，促銷與 App 內購價格可能不同，實際金額以結帳畫面為準。直接價格頁 x.ai/pricing 在同一時間只顯示美元。

補充：

• 美元與新台幣不是固定匯率：$8 對應 NT$249，$30 對應 NT$990，$100 對應 NT$3,390，$200 對應 NT$6,690。
• 月繳畫面的 Plus 下方同時出現「NT$249/year」字樣，與年繳的 NT$2,490 不符，官方頁面內部不一致；本指南以 NT$249／月為準，結帳前請再看一次畫面。
• 首月 5 折是頁面當下的促銷，會變動，不建議當成長期價格。
• 在 Apple App Store 或 Google Play 內購的價格，官方沒有另外公布，請在商店的訂閱畫面確認。

舊方案還在嗎

仍可續用，但官方現行頁面已把新訂戶導向 The X Subscription。

舊方案的美元價格：官方現行頁面沒有列 SuperGrok 或 SuperGrok Heavy 的價目表，唯一能引用的是 x.ai/pricing 的敘述（Premium 取代合計 $90／月的 SuperGrok、Cursor Pro 與 X Premium+），因此本指南不寫舊方案的價格。要知道自己現在付多少，請看訂閱所在平台的扣款紀錄。

每週用量池與 top-up

付費用戶的用量機制，來源是官方 Grok FAQ 與 X Subscription 文件：

• 新機制是單一每週共用用量池，可跨 Chat、Imagine、Voice、Build、Bot 自由分配；FAQ 說 2026 年 6 月起逐步上線。
• 在 Settings → Usage 可以看到進度、各產品占比與重置時間。
• Grok 與 Cursor 共用同一個每週池，每週重置。
• 用完後，付費功能會暫停；免費層的 Chat 與 Voice 額度仍可使用（獨立計算）。
• 要繼續用，可以買 Extra Usage Credits（最低 $5、目前只能在網頁購買、一年後到期、單價高於方案內含），或開啟 Auto Top Up（自訂金額與每月上限）。
• 720p 影片超過方案上限時，會自動降到 480p。

Grok Bot 的用量有兩套說法，官方頁面不一致，原因是屬於不同的方案世代：

切換前要知道的事

依官方 X Subscription 說明：

1. 切換是永久的，客服也無法復原。
2. 舊訂閱會在結帳時取消，並按比例退款。
3. 如果舊訂閱是 Apple 或 Google Play 買的，要自己到商店取消，退款由商店決定。
4. 訂閱只由 X Subscription Corp. 直接販售，不授權經銷商。
5. 舊方案與新方案的用量規則不同（例如上表的 Grok Bot），切換前先看清楚新方案的規則。

切換前建議自己確認：目前訂閱的平台、續訂日、是否有年繳餘額、是否需要 Grok Bot（Plus 不含）。

資料來源：The X Subscription 公告、x.ai/pricing、X Subscription 價格、X Subscription 總覽、X Subscription 用量、Grok FAQ、grok.com/plans、Grok Bot 擴大方案、Grok Business、X Premium（X 說明中心）（2026-11-06 查詢）

模式與模型

Grok 的「模式」和「模型」是兩件事，也是最容易搞混的地方：app 輸入框給你選的是模式（Fast、Auto、Expert、Heavy），官方公告談的是模型（Grok 4.5、4.6、4.7）。兩者的對應關係，官方頁面沒有公開說明。本章分開講，並把官方沒寫清楚的地方明確標出來。

app 內的模式選單

grok.com 輸入框的模式選單在 2026-11-06 實測有四個項目，未登入也看得到。這四個模式分別是 Fast、Auto、Expert、Heavy。官方公開頁面沒有逐一說明各模式的用途。

另外還有一個需要登入的「Premium — Unlock extended capabilities」項目。

關於這份選單，能確定與不能確定的事如下：

實務上的建議：以自己帳號在介面上看到的選項為準。需要確認某個模式是否可用，先在登入後的選單裡點選看看，再回 Settings → Usage 觀察用量變化。

x.ai/grok 的產品介紹另外提到 “Deep reasoning — Step-by-step thinking you can follow and verify”，以及多個 agent 並行處理、推理過程可稽核的 Multi-agent 能力，但官方沒有說明它們對應到上表哪個模式或哪個方案。

模型時間線

下表整理 x.ai/news 與 docs.x.ai 的公開資訊。日期以官方頁面為準：

官方對自家模型的評價（“most intelligent”、“most powerful”）是廠商自述，本指南不另外比較。

Grok 4.5、4.6、4.7 的定位

重點是 Grok 4.7 的公告原文寫的是「available today in Cursor and Grok Build … Grok API, third-party coding harnesses」，沒有提到 grok.com。其他零散的線索彼此並不能拼出結論：

• x.ai/grok/business 的模型欄列了 Grok 4.7（Business 方案）。
• x.ai/pricing 把 Premium 寫成 “Latest Grok models”。
• 消費端對話的預設模型究竟是 4.5 還是 4.7，官方頁面沒有直接說。

因此，本指南不寫「Grok 4.7 已進入 grok.com」，也不寫「沒有」。想確認的話，請在登入後的帳號裡查看模式選單，或到 x.ai/news 與 docs.x.ai/developers/release-notes 看有沒有新的公告。

Grok 5 在官方 news 與 docs 都沒有任何公告，本指南不討論傳聞中的發佈日。

舊名稱與消失的功能

2025 年常見的名稱，在查詢日的官方現行頁面有不同的處理：

遇到網路文章還在教你按 DeepSearch 或 Think，請先對照自己的介面。沒看到就是沒有，不要被舊教學誤導。

API 模型簡述

Grok 的 API 模型與 app 的模式是兩套獨立的東西，計費也分開（方案內含的是 app 用量，API 另按費率計費）。下表只列各模型的基本資料，完整的呼叫方式、計價、rate limit 與退役對照見後面的 API 章節。價格單位是 USD／100 萬 token，輸入 token 在 200k 以下的標準價：

幾點補充：

• prompt 達 200k token 以上時，整個請求改用較高的單價。
• 官方說 Grok 4.7 Fast（同模型、2 倍速、2 倍價）只在 Cursor 與 Grok Build，不在公開 API。
• 2026-05-15 起，grok-4-1-fast-*、grok-4-fast-*、grok-4-0709、grok-3 等舊 slug 已退役，請求會自動轉址到 grok-4.3 並按其價格計費。
• 圖片、影片與語音另有 grok-imagine-image-2.0、grok-imagine-video-1.5、grok-voice-3.0 等模型，細節留到 API 章節。

資料來源：Grok 4.7、Grok 4.6、Grok 4.5、Grok 4.5 everywhere、Grok 4.1、Grok 4、Grok 3、Grok Voice 3.0、Grok Skills、Grok Automations、x.ai/grok、x.ai/pricing、Grok Business、Grok FAQ、Models（API）、Release notes、May 15 retirement、Grok on the App Store（2026-11-06 查詢）

日常對話：搜尋、檔案、語音與個人化

這一章整理 Grok 在 grok.com 與 iOS、Android app 裡最常用的對話功能。查詢日為 2026-11-06，官方頁面沒有明寫的細節會標「官方未公布」，不以舊教學補上。

搜尋與 X 即時資料

Grok 與其他聊天機器人最明顯的差別，是官方把搜尋公開 X 貼文列為內建能力。官方說明的運作方式：

• Grok 會自行決定要不要搜尋公開的 X 貼文與即時網頁搜尋，再用結果回答。
• x.ai/grok 的產品頁寫明回答會附上來源引用，並可針對同一主題追問。
• 搜尋範圍是公開貼文。X 的說明指出，把帳號設為「保護貼文」後，貼文不會被用來訓練模型，也不會在回答其他使用者的問題時被引用。

實際使用時，可以直接用自然語言要求 Grok 查 X，例如：

App Store 的官方說明也把這類用法寫成「advanced searches on X」。回答仍可能出錯，官方在 Consumer FAQ 裡明講 Grok 有時會提供不準確或不適當的內容，並建議使用者自行查證。

輸入框的模式選單

未登入的 grok.com 輸入框可以看到 Fast、Auto、Expert、Heavy 四個模式，另有需要登入才能展開的「Premium」項目。每個模式對應哪個模型、哪些方案可用，官方頁面沒有直接說明，請看模型與模式那一章，或登入後在 app 內確認。

2025 年的教學常提到 DeepSearch、DeeperSearch、Think、Big Brain 這幾個名稱。截至查詢日，官方現行頁面（x.ai、docs.x.ai、App Store 說明）都沒有使用這些名稱。App Store 說明改用「deep research on the web」描述網路深度研究，x.ai/grok 則寫「Deep reasoning」與「Multi-agent」。這些名稱是否改名、併入哪個模式，官方未公布。

x.ai/grok 對 Multi-agent 的描述是多個 agent 並行處理子問題、每個 agent 的推理可稽核，結果合併成一個附引用的回答。該頁把它放在 SuperGrok 底下；新方案體系中對應哪一檔，官方未公布。

檔案上傳

在對話輸入框旁按 +，選擇裝置上的檔案；網頁版也可以拖放。一則訊息可以附多個檔案，Grok 處理完會先確認上傳成功再回答。

官方註明各平台支援度略有差異，網頁版的文件格式通常最完整，限制也可能依平台或訂閱方案微調；超過限制時 Grok 會顯示錯誤訊息。

能做什麼

官方的說明把用途分成五類：綜合多份檔案、轉換（摘要、改寫、把簡報轉成大綱）、擷取（表格、引文、中繼資料）、分析（圖表、程式碼、CSV 與 XLSX 的資料視覺化，以及音訊與影片的轉錄）、跨文字與圖片的多模態推理。

使用上的限制與建議

• 非 PDF 檔案裡嵌入的圖片，不一定會被當成圖像處理，Grok 主要擷取文字。
• 音訊與影片可以上傳，但轉錄品質不穩定。
• 超過 100 頁的 PDF，Grok 會著重文字與重點圖像；提問時請用實際頁碼指定範圍，或把文件拆小。
• 圖片分析建議使用 1000 x 1000 像素以上的圖。
• 混合上傳（TXT、PDF、PPTX、圖片、程式碼）可以一起處理；很複雜的需求可拆成追問。

常見錯誤

已上傳的檔案在網頁版可到 grok.com/files 管理與刪除。刪除的對話與檔案，會在標準保留期限內從系統移除，法律、合規或安全需要保留的除外，細節見隱私與資料那一章。

語音模式

官方對語音的描述有幾處可以確認：

• App Store 說明列有 Grok Voice Mode：與 Grok 自然語音對話、即時回覆，並可個人化互動方式、選擇不同的對話風格。同一份說明也提到可以只用聲音來生成圖片。
• x.ai/grok 把語音寫成「sub-second latency」的來回對話。
• docs.x.ai 的 Grok 總覽把語音列為 Grok 的功能之一（hands-free），沒有逐平台說明。
• 2026-07-15 官方公告新增 21 個旗艦聲音，並改善原有五個聲音的自然度。這項公告屬於 Grok Voice 產品線，消費端 app 的語音選單是否與之同步，官方未公布。
• Grok Voice 3.0（2026-10-14）是語音模型，官方說明它驅動 Grok Bot 的語音模式與 Tesla 車內的 Grok。消費端 app 的語音現在跑的是哪一版模型，官方未公布。

語言方面，官方兩處數字不一致：App Store 標示英文加 38 種語言，x.ai/grok 寫 30 多種語言。繁體中文語音的支援細節，官方未公布；需要時請直接在 app 內實測。

在 X 內使用 Grok 語音時，X 的說明指出語音輸入的轉錄或翻譯內容可能與 xAI 共享，用於個人化與訓練，開關位置見隱私與資料那一章。

自訂指示、記憶與個人化

這一塊要分清楚官方「有明確寫出來」的，與只出現在行銷頁的：

Custom instructions 與 Memory 只在產品頁出現，沒有對應的說明文件，所以本指南不寫操作路徑。若想讓 Grok 固定遵守某種格式或流程，官方有完整說明的做法是 Skills（見下一章）。

Grok Bot 的記憶是另一套機制：每個 Bot 各自保存偏好、角色與過往工作摘要，與 grok.com 的對話記憶無關。

Projects 的部分，docs.x.ai 的 FAQ 只提到 grok.com 有 Projects（用錯網域如 grok.x.ai 會缺少該功能），團隊版公告提到可透過 Projects 做 Collection Search；詳細用法與方案限制，官方未公布。

對話紀錄與分享

• 查看紀錄：iOS 點左上角頭像進入對話紀錄；grok.com 點右上角的紀錄圖示（三條線與放大鏡）。
• 分享對話：網頁版按 Share，或點對話下方的分享圖示，會產生公開連結。官方提醒連結若貼在社群平台，可能被搜尋引擎索引。
• 撤銷分享：到 grok.com/share-links，按連結旁的 Remove。
• 團隊版：Grok Business 的團隊 workspace，分享連結只有已授權的成員打得開。
• 從其他 AI 轉移對話：App Store 說明寫「Easily transfer your conversations and context to Grok」，轉移的機制與支援來源，官方未公布。

用量用完之後

付費用戶共用一個每週用量池，Chat 也從這裡扣。用完時付費功能會暫停，但免費層的 Chat 與 Voice 額度仍可使用，額度獨立計算、各自重置。方案與用量規則見方案與價格那一章。

Grok Imagine：圖片與影片生成

Grok Imagine 是 Grok 的圖片與影片生成功能。入口有三個：grok.com/imagine、iOS app、Android app；也可以直接在一般對話裡要求 Grok 畫圖或做影片，並用後續提示修改。官方產品頁（x.ai/grok）把它描述為文字轉圖、文字轉影片放在同一個對話串，生成後可以用追問繼續編修。

查詢日為 2026-11-06。影片的解析度與長度，官方頁面彼此不一致，本章會並列各處說法。

圖片：Imagine Image 2.0

2026-08-07，官方宣布 Imagine Image 2.0 成為 grok.com/imagine 與 iOS、Android app 的 Quality Mode。官方對它的定位是「做得出可以直接用在工作上的圖」，重點在以下幾點。

解析度方面，x.ai/grok 的產品頁寫圖片最高可到 2K。

App Store 說明另外提到幾種常見的編輯：移除物件、更換背景、套用藝術風格、把照片轉成動態影片，以及只用語音下指令來生成圖片。

開始的方式

grok.com 首頁的輸入框下方有「Create an image」等快捷選項，點進去就能開始一段圖片生成的對話；也可以直接進 grok.com/imagine 使用 Quality Mode 與範本。生成後用後續提示描述要改的地方，或用 magic wand 指定區域，不需要重寫整段提示。

API 端的圖片生成

開發者若要用程式生成圖片，xAI API 的圖片端點對應的模型是 grok-imagine-image-2.0。官方文件的規格：n 可設 1 到 10；回傳的預設是暫時性網址，需要盡快下載；編輯最多帶 5 張來源圖；另提供 21:9 與 5:2 的比例。以下是 docs.x.ai 圖片生成頁的官方範例：

curl -X POST https://api.x.ai/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "A collage of London landmarks in a stenciled street‑art style"
  }'

範本

Image 2.0 同時推出一批範本，把常見的圖片工作流程包成現成起點，使用者只要提供素材。官方公告列出的範本如下（名稱為官方原文）：

官方公告還示範了「一個世界、多張圖」的用法：分別生成角色、場景與道具，維持同一種風格，再拿去當影片的參考素材。

影片：Imagine Video 1.5

影片模型的時間線如下：

• 2026-06：Imagine Video 1.5 發表，官方說明為更好的動態、物理與音訊。
• 2026-07-31：加入文字、圖片與聲音參考，並支援只靠文字提示生成影片（text-to-video）與原生 1080p。

7 月底這次更新的重點：

圖片參考與聲音參考一開始只在美國、對 SuperGrok Heavy 與 SuperGrok Plus 開放，官方說數日內推到所有方案。App Store 說明也提到影片可帶聲音。

解析度與長度：官方頁面不一致

幾份資料合起來，合理的解讀是各方案的影片上限不同，但官方沒有逐方案列出 480p、720p、1080p 與長度的對照表。實際可選的解析度與秒數，請以自己帳號在 app 內顯示的選項為準，本指南不替各方案寫死數字。

為了讓你知道模型本身的能力範圍，這裡附上 API 文件的規格作對照（不等於 app 的限制）：

用量

Imagine 與 Chat、Voice、Build、Bot 共用付費方案的每週用量池。官方說明不同產品耗用不同：一則聊天訊息用的運算很少，生成高品質影片則多得多。到 Settings 的 Usage 可以看各產品的占比。用量用完時，付費功能暫停，免費層的 Chat 與 Voice 額度不受影響；Imagine 的免費額度，官方只寫「限量」，數字未公布。

浮水印與使用規則

浮水印

• 生成的圖片與影片都帶有 Grok 浮水印，標示內容由 AI 生成。
• 官方明說沒有關閉浮水印的設定。
• 官方也指出，部分司法管轄區在法律上要求標示 AI 生成內容。
• 使用條款（Terms）寫明，使用者可能被要求、或由 SpaceXSI 自動加上 AI 生成的揭露標示。
• Acceptable Use Policy 禁止「剝除、更改或規避內嵌的來源中繼資料或浮水印」。移除或遮蓋浮水印屬於違規，可能被停權。

輸出的權利

官方 Consumer FAQ 的說法是：使用者擁有輸入與輸出（包含生成的圖片），可以依自己的需求使用，包含商業用途。官方同時要求依品牌規範（Brand Guidelines）標示作品由 Grok 生成。商業使用前，請自行讀過條款原文。

內容規則

Acceptable Use Policy 中與圖片、影片直接相關的禁止事項：

• 把真人「脫衣」或裸化，或改動真人的影像或肖像，使其呈現親密或性的情境。
• 以色情方式描繪真人肖像。
• 欺騙性地冒充真人。
• 以誹謗或不實的方式描繪某人。
• 性化或剝削兒童。官方表示會把疑似兒少性剝削內容通報給 NCMEC。

在澳洲，使用條款另有專屬規定：不得上傳或嘗試生成兒少性剝削、鼓吹恐怖行動、鼓吹犯罪或暴力、鼓吹涉毒犯罪，以及特定癖好題材的內容。

違規可能導致帳號被停權或終止，內容也可能被刪除。看到違規內容時，可在 Grok 內點「⋯」選 Report Issue，或寄信到 [email protected]。成人內容的顯示設定與年齡限制，見隱私與資料那一章。

工作流程與 Grok Bot

2026 年 5 月到 8 月，Grok 陸續加入 Connectors、Skills、Automations、Build，以及獨立的 Grok Bot。這些功能名稱相近，但屬於兩個不同的產品：前四項是 grok.com 與 app 內的功能，Grok Bot 是另一個 app。查詢日為 2026-11-06。

Connectors（含自訂 MCP）

Connectors 讓 Grok 在對話中直接存取外部工具與資料：搜尋信件、瀏覽雲端檔案、查行事曆，不必來回複製貼上。

三種連接器

docs.x.ai 把連接器分成三類：

• 內建連接器：由 SpaceXSI 維護，用 OAuth 登入一次即可。
• 連接器目錄：預先設定好的第三方服務，同樣只要登入。完整清單在 grok.com/connectors。
• 自訂 MCP 連接器：連到你自己的 Model Context Protocol 伺服器。

2026-05-06 的上線公告列出的項目略有不同：SharePoint、Outlook、OneDrive、Google Workspace、Notion、GitHub、Linear，加上自訂 MCP。Notion、GitHub、Linear 在現行 docs 的內建表裡沒有出現，是否歸在目錄裡，官方未逐項說明，請以 grok.com/connectors 實際看到的清單為準。

怎麼加

• 網頁：到 grok.com/connectors，按 New Connector，選服務並完成 OAuth。也可以在對話輸入框按 +，選 Connectors，再按 Add connector。
• iOS、Android：Settings，再選 Connectors。
• 官方說明 Grok 只會要求它需要的權限；連接後，只要問題和該服務有關，Grok 會自動使用對應的工具。
• 以 SharePoint 為例，公告說明預設可搜尋與讀取；開啟寫入權限後，才能建立與修改文件、清單與頁面。
• 隱私政策寫明：用 Google OAuth 連接的 Google 內容，不會用於 SpaceXSI 的 AI 訓練。

自訂 MCP

在 grok.com/connectors 按 New Connector，選 Custom，輸入 MCP 伺服器網址並完成驗證，Grok 會自動讀取伺服器公開的工具。條件只有一個要特別注意：伺服器必須能從公開網際網路連到。localhost、127.0.0.1、10.x.x.x、172.16.x.x、192.168.x.x 這類私有位址會被拒絕；在本機執行的伺服器需要靠隧道服務對外（docs.x.ai 的 Custom MCP Tunneling 頁有說明）。

Grok Business 與 Enterprise

團隊版必須先由管理員到 console.x.ai 的 Grok Business，再選 Connectors，用 Add Connector 從目錄加入或用 Other 填入 MCP 網址，成員才能在 grok.com/connectors 連接自己的帳號。新增與移除需要 Team Read-Write 權限。管理員移除連接器後，成員無法再使用，且該連接器相關的索引資料可能被移除。

API 端的 MCP

開發者若要在 API 內使用 MCP，xAI API 有 Remote MCP 工具，由 xAI 伺服器代你連接 MCP 伺服器，僅支援 Streamable HTTP 與 SSE。以下範例取自 docs.x.ai 的 Remote MCP 頁：

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
  "model": "grok-4.7",
  "input": [
    {
      "role": "user",
      "content": "What can you do with https://github.com/xai-org/xai-sdk-python?"
    }
  ],
  "tools": [
    {
        "type": "mcp",
        "server_url": "https://mcp.deepwiki.com/mcp",
        "server_label": "deepwiki"
    }
  ]
}'

Skills

Skills 是「教 Grok 一次，之後每次對話都記得」的機制，在 grok.com、iOS、Android 都可用。官方公告說明每個帳號預設就有 xAI 提供的內建 skill，不必設定：

• 自訂 skill 有三種建法：在對話中描述、上傳檔案、從頭撰寫。也可以在做完一件事後，叫 Grok 把剛剛學到的流程存成 skill。
• 你自己的版本優先於內建版本，可以直接覆寫。
• 公告說明 Grok 能產出可直接分享的 Word、PowerPoint、Excel 與 PDF 檔，也能重整你上傳的既有檔案。
• 公告寫明 Skills 上線時運行在 Grok 4.3 上。

自訂 skill 的分享方式與團隊管理，官方公告只提到「可以分享」，細節未公布。

Automations

Automations 是 Grok 自己執行的工作：描述一次，選定何時執行，Grok 做完再回報。入口是 grok.com/automations，iOS 與 Android app 內也有。

也可以直接在對話裡說「每天早上查新聞，標出和定價有關的」，Grok 會幫你建立。排程對所有人開放；信件觸發在公告發表時寫的是「included with SuperGrok」。新方案（The X Subscription）下對應哪一檔，官方未公布。

Build

Build 讓你在對話裡描述一個網站、app、遊戲或儀表板，Grok 在對話中即時建出可用的版本，之後可繼續修改。

• 方案：2026-07-28 以 Early Beta 形式只開放給 SuperGrok Heavy；2026-08-19 起所有方案、網頁與手機（iOS、Android）都能使用。
• 發佈：每個發佈的 app 有自己的 *.grok.me 網址；存取權限可選「只有你」「知道連結的人」或「公開」；也可以綁定自己的網域。
• 其他功能：Remix（讓別人複製你發佈的 app 再修改）、匯出到 GitHub、Secrets（把第三方服務的金鑰存在 app 程式碼之外）、用 Connectors 把業務資料做成可篩選的即時儀表板。
• 呼叫 Grok 的 app：可為單一 app 開啟 SpaceXSI APIs，讓 app 自己呼叫 Grok 做聊天、圖片與語音，不必建立或貼上金鑰；權限以 app 為單位，可隨時撤銷。
• 注意：docs.x.ai 說明 grok.com 的 Build 會保留對話與 build session（為了跨 session 發佈 app），且不提供 Private Chat。

不要與終端機的 Grok Build CLI 混淆：CLI 是另一個 coding agent，安裝與用量另有說明。Grok Studio 已停止支援，官方指示改用 Grok Build。

Microsoft 365 與 Google Workspace add-in

官方 Grok 4.5 的消費端公告也提到，Grok 可直接在 Word、Excel、PowerPoint 與 Outlook 內運作。安裝方式與所需方案，官方公告列表只有上述摘要，未公布更多細節。

Grok Bot

它是什麼

Grok Bot 是「有自己電腦的 AI 隊友」。官方說明每個 Bot 在持久的雲端電腦（有瀏覽器、檔案系統與終端機）上工作，你用訊息交辦任務，它在實際的工具裡完成，需要核准時才回來找你。

• 關掉 app 或電腦，雲端上的工作仍會繼續。
• 可同時有多個 Bot，彼此傳訊、共享脈絡，也能放進群組聊天。
• 可請 Bot 在你下一次做某件事時旁觀，把流程存成可重複執行的 routine。
• 每個 Bot 各自保存偏好、角色與過往工作摘要；你所有 Bot 共用同一台雲端電腦，官方提醒不要把不同 Bot 當成安全邊界。
• Bot 登入網站時，密碼走 Vault 或 Secure Form，Bot 本身看不到密碼；遇到 SSO、passkey、CAPTCHA 這類只能人工處理的步驟，會把電腦交還給你。

與 grok.com 的差別

docs.x.ai 的常見問題直接寫明：Grok Bot 與 grok.com、Grok 手機 app 不是同一個東西，在 Grok app 看到的付費牆或「Weekly SuperGrok Limit」也與 Grok Bot 無關。

含在哪些方案

新方案（The X Subscription，2026-10-12 起新客預設）

• Premium、Super、Ultra 含 Grok Bot，個人與團隊席位皆同。
• Plus 與 Free 不含。
• 官方文件說明 Bot 用量從該席位的每週共用用量池扣（與 Grok、Cursor 共用），不是另外加上去的額度。
• 用量在 grok.com/dashboard 的 Usage 查看；超過後以預付點數補。

舊方案（仍可續用）

• 2026-08-11 beta 公告開放對象：SuperGrok、SuperGrok Plus、SuperGrok Heavy；Cursor Pro、Pro+、Ultra；Cursor Teams 的 Standard 與 Premium。2026-08-26 公告表示所有 SuperGrok、Cursor Pro 與 Cursor Teams 方案都含 Grok Bot。
• 兩次公告都寫：Grok Bot「有自己的用量」，與 Grok、Cursor 的方案用量分開計算，交給 Bot 的工作不會消耗原方案用量。
• docs.x.ai 的 Grok Bot 常見問題說明：舊方案下用量記在你的 Cursor 帳號，不是 Grok 或 X；達到 Weekly usage limit 後，若開啟 on-demand，超出部分透過 Cursor 計費。
• 連結 SuperGrok 或 X Premium+ 的規則：可連結個人版 SuperGrok、SuperGrok Plus、SuperGrok Heavy、X Premium+；SuperGrok Lite 與 Grok Enterprise 不能連結；連結永久，不能自己解除；Cursor 方案與 SuperGrok 不會相加，而是取用量較大的那一個。
• 如果之後切換到 The X Subscription，Bot 的用量就改由新的共用用量池供應，且切換不可逆。

「獨立用量」與「吃共用池」是兩個方案世代的不同規則，不是文件矛盾；訂閱前先確認自己屬於哪一邊。

平台

2026-08-11 的公告寫「desktop and iOS」，公告頁的下載按鈕也是 macOS。docs.x.ai 現行頁面寫的支援平台更多：桌面版 macOS、Windows、Linux，加上 iOS（iOS 18 以上）與 Android（Android 9 以上）。官方頁面不一致，以你實際在 x.ai/bot 與商店看到的下載選項為準。Enterprise 方案的開放方式請洽官方業務。

核准機制與 X 整合

• 動作預設由 Auto Review 判斷，多數動作自行執行；需要你同意時，Bot 會在對話中顯示核准卡，可選擇允許一次、永遠允許或拒絕。官方建議在請求裡寫明邊界，例如寄信、發佈、刪除、購買一律先問。
• 由 routine 或其他 Bot 觸發、你不在場的核准，約 30 分鐘後失效。
• 2026-08-29 起可連接 X 帳號，讓 Bot 搜尋貼文、讀時間軸、查提及；付費用戶有免費的 X API 點數可起步。
• 在 X 貼文或回覆中標記 @bot，可把貼文當成任務交給你的主要 Bot。條件是 Grok 帳號已連結 X 帳號；澳洲、英國、歐盟、冰島、列支敦斯登與挪威的 X 帳號目前不支援標記。
• 在 X Chat 內與 Grok Bot 對話時，適用 Cursor 的隱私政策，並同時適用 X 的隱私政策。

Grok Bot 的隱私設定另有一套，見隱私與資料那一章。

隱私與資料控制

這一章建議每個人都讀。重點有三個：消費者帳號的內容預設可能被用來訓練模型，要自己到設定裡關；在 X 裡面用 Grok 適用 X 的設定，與 grok.com 是兩套；未登入使用的訓練規則，官方文字不一致。

查詢日為 2026-11-06。Consumer FAQ 頁面標示的日期是 2025-05-12，但頁尾與品牌名稱已更新到 2026 年，本指南視為現行版；其中少數句子（例如語音只在 iOS）已明顯過時，不引用。

先分清楚是哪一套服務

官方隱私政策明講：SpaceXSI 與 X Corp. 是不同的公司。

關閉 Improve the model

官方預設的說法是：SpaceXSI 可能用你的內容與互動（提示、搜尋與其他你提交的資料）加上 Grok 的回覆來訓練模型，並說明你可以控制。關閉路徑如下：

幾個要注意的細節：

• 關閉後，只有新的對話不會用於訓練，已經產生的對話不受影響。
• 即使關閉，你自願提供的回饋（例如按讚或倒讚並說明原因）仍可能被用於訓練。
• 官方的 Private Chat 是另一條路徑：用 Private Chat 的內容不會用於訓練。
• Business 與 Enterprise 客戶的內容，官方明說不會用來改進模型。

Private Chat

在 Grok 畫面右上角有一個幽靈圖示，點選後進入 Private Chat。

• 對話不會出現在你的歷史紀錄。
• 內容與互動不用於模型訓練。
• 對話會在 30 天內從 SpaceXSI 系統刪除。官方的例外：已經去識別化或化名、與帳號脫鉤的資料，以及因安全、資安或法律原因必須保留的資料。

兩個限制：官方文字寫「where available」，也就是並非每個情境都有；另外，docs.x.ai 說明 grok.com 的 Build 會保留對話與 build session，不提供 Private Chat。

未登入使用：官方說法不一致

不登入就能在 grok.com 聊天，但關於這時的資料如何處理，官方有三段文字互相對不上：

三者的優先順序，官方沒有說明。比較保守的做法：不要在未登入狀態輸入個資、工作機密或客戶資料；要處理這類內容，先登入、關閉 Improve the model，或改用 Private Chat。

個人化：Personalize Grok using X

Grok 可以用你的 X 資料與互動來個人化回答。開關位置：

• Grok app：Settings，Data Controls，Personalize Grok using X
• grok.com：Settings，Data，Personalize Grok using X

如果你用 X 帳號登入，Terms 寫明你同意 SpaceXSI 可以帶入你的 X 個人檔案（含生日）、帳號與位置資訊、偏好、貼文紀錄、使用資料，以及你在 X 內與 Grok 的對話紀錄。把 X 帳號連到 Grok 的路徑是 grok.com 的 Settings，Account，Connect your X Account。

刪除與下載資料

• 提出刪除後，資料最多 30 天內會從 SpaceXSI 系統移除；法律、安全或資安需要保留的資料除外。
• 帳號刪除後 30 天內重新登入並確認，可以還原。
• 資料下載的具體格式與等候時間，官方未公布。FAQ 只寫可以在 Settings 的 Data Controls 下載或刪除資料。
• 其他資料權利申請（存取、刪除等）：x.ai/privacy-portal。一般客服 [email protected]，隱私聯絡信箱 [email protected]。
• 官方表示不會販售你的資料。

人工審查與資料用途

• 官方說明，SpaceXSI 會用自動化分類器與安全工具監控違規；有限的授權人員可能為了改善模型、調查資安事件與濫用、履行法律義務而檢視對話。
• 官方建議不要在提問中輸入個人或敏感資訊。
• 使用條款寫明：你擁有輸入與輸出；同時你授與 SpaceXSI 廣泛的使用授權，用途包含提供服務、改進產品與模型，以及遵守法律與安全需求。
• 使用者使用 Grok 的自主動作（agentic actions，如瀏覽網頁、執行程式碼、寄送訊息、修改檔案）時，條款寫明這些動作的責任由使用者承擔。

X 內的 Grok：另一套設定

在 X 的導覽列點 Grok 圖示（x.com/i/grok），適用的是 X 的隱私政策，不是 SpaceXSI 的。X 說明頁的重點如下。

• X 說明指出，X 可能把你的公開 X 資料與你在 X 內和 Grok 的互動，分享給 xAI 以訓練與微調模型。公開資料包含公開貼文與其互動、公開 Spaces 與公開個人檔案。
• 語音輸入也算在內：轉錄或翻譯的內容可能被分享。
• 關閉訓練後，仍可使用 Grok。但由 Grok 驅動的 X 功能（例如推薦），關閉並不阻止已部署模型因正常使用而學習。
• 同樣地，按讚或倒讚的回饋即使退出訓練，仍可能被用來訓練。
• 在 X Chat 內使用 Grok Bot 時，訓練退出走同一個 X 設定頁；Grok Bot 的資料保留到你刪除 Grok Bot 帳號為止，可在 Grok Bot 設定內刪除。
• 這份 X 說明頁沒有標示日期，且仍以 xAI 稱呼公司，內容可能不是最新，以 X 設定頁實際顯示為準。

年齡限制與內容設定

年齡

• 使用 Grok 須年滿 13 歲（或所在國家規定的最低年齡）。13 到 17 歲需要父母或法定監護人同意，且監護人必須同意服務條款。
• iOS App Store 的年齡分級是 16+。
• 官方明講，視你選擇的功能與輸入，輸出可能含粗話、粗俗幽默、性情境或暴力。FAQ 舉例：要求 Grok 用「unhinged」風格，可能得到冒犯、不恰當的回應。官方也請家長在監督青少年使用時，運用 app 設定中的資料控制選項。

成人內容的設定

澳洲專屬條款寫明：SpaceXSI 以 age assurance 判斷澳洲使用者是否未滿 18 歲，在確認滿 18 歲前，可能無法存取 18+ 成人內容；同一段也寫使用者可以在 Settings > Data Control 限制自己接觸可能含 18+ 成人內容的媒體。這句話出現在澳洲條款裡，其他地區是否相同，官方文字未說明。

政策上禁止的事

Acceptable Use Policy（2026-08-14 生效）列出的禁止事項，與資料和內容直接相關的包含：

• 脫衣或裸化真人、把真人影像改成親密或性的情境、以色情方式描繪真人肖像、欺騙性冒充真人。
• 性化或剝削兒童；官方表示疑似兒少性剝削內容會通報 NCMEC。
• 越獄、對抗式提示與 prompt injection。
• 剝除或規避內嵌的來源中繼資料或浮水印。
• 用輸出或服務來開發與 SpaceXSI 競爭的機器學習模型。

違規可能被停權或終止帳號。檢舉方式：在 Grok 內點「⋯」選 Report Issue，或寄信到 [email protected]；安全相關回報信箱是 [email protected]，資安漏洞走 HackerOne。

Grok Bot 與 API 的資料

• Grok Bot：使用 Cursor 帳號驗證與資料設定，訓練退出依對應的 Cursor 帳號與隱私設定。它需要雲端資料儲存，所以舊的 Legacy Privacy Mode 帳號在開始前會被要求切換到 Privacy Mode。你的所有 Bot 共用同一台雲端電腦，放在上面的東西，所有 Bot 都能存取。
• xAI API：API 的請求與回應預設加密保存 30 天（供濫用稽核），之後自動刪除；官方說明未經明確同意，不會用 API 的輸入輸出訓練模型。有需要可申請 Zero Data Retention，但官方自己不建議多數客戶啟用，因為會停用有狀態對話、Files、Collections、Batch 等功能。

API 快速入門與模型清單

這章從 xAI API 的帳號、API key 到第一個請求，再到目前可用的文字模型、價格與 reasoning effort。API 與 Grok 聊天機器人（grok.com、App）是分開的產品，帳單也分開。價格與模型清單每個月都在變動，本章的數字是 2026-11-06 查詢 docs.x.ai 的結果，使用前請再核對 docs.x.ai/developers/models 與 docs.x.ai/developers/pricing。

取得 API key

流程出自 docs.x.ai 的 Quickstart（developers/quickstart）：

1. 到 console.x.ai 註冊帳號。
2. 先儲值（load with credits），才能開始使用 API。
3. 在 API Keys 頁產生 key。
4. 把 key 放進環境變數 XAI_API_KEY，或寫進專案目錄的 .env。

export XAI_API_KEY="your_api_key"

出處：docs.x.ai Quickstart，Step 2。

幾件相關的事實，出自 docs.x.ai 的 Security FAQ（developers/faq/security）：

• API key 綁定的是 team，不是個人。
• key 外洩時，xAI 與 GitHub Secret Scanning 合作：偵測到洩漏會停用 key 並寄 email 通知。你也可以在 Console 對 key 選 Disable key 或 Delete key。
• Management API（管理 key、帳務、audit log）使用另一組 management key，base URL 是 https://management-api.x.ai，出自 developers/management-api-guide。

Base URL 與認證

GET /v1/models 會列出該 key 可用的模型，包含價格、別名與 reasoning effort 能力。另有 /v1/language-models、/v1/image-generation-models、/v1/video-generation-models 分類端點。

第一個請求

官方 Quickstart 的範例都使用 Responses API（/v1/responses），不是 Chat Completions。下面四種寫法都出自同一頁，範例中的模型是 grok-4.7。

curl

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "input": "Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}"
  }'

Python，使用 OpenAI SDK（pip install openai）

from openai import OpenAI

client = OpenAI(
    api_key="<YOUR_XAI_API_KEY_HERE>",
    base_url="https://api.x.ai/v1",
)

response = client.responses.create(
    model="grok-4.7",
    input="Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}",
)

print(response.output_text)

JavaScript，使用 OpenAI SDK（npm install openai）

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.XAI_API_KEY,
  baseURL: "https://api.x.ai/v1",
});

const response = await client.responses.create({
  model: "grok-4.7",
  input:
    "Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}",
});

console.log(response.output_text);

Python，使用官方 xai-sdk（pip install 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.7")
chat.append(user("Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}"))

print(chat.sample().content)

JavaScript，使用 Vercel AI SDK（npm install ai @ai-sdk/xai zod）

import { xai } from "@ai-sdk/xai";
import { generateText } from "ai";

const { text } = await generateText({
  model: xai.responses("grok-4.7"),
  prompt:
    "Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}",
});

console.log(text);

以上四段出處皆為 docs.x.ai Quickstart（developers/quickstart）。

SDK 與 OpenAI 相容

• OpenAI SDK：Python 與 JavaScript 都只要把 base_url（JS 是 baseURL）改成 https://api.x.ai/v1，其餘照 OpenAI 的 Responses API 用法。
• xai-sdk（Python）：官方 SDK，文件稱它使用 gRPC，涵蓋 Collections、Voice、API key 管理等功能，可以和 REST 的 Responses API 混用。PyPI 在查詢日顯示最新版為 1.21.0（2026-10-23 上傳），需要 Python 3.10 以上。
• JavaScript：官方文件的 JS 範例只用 OpenAI SDK 與 Vercel AI SDK（@ai-sdk/xai），文件中沒有提到官方的 xAI JavaScript SDK。
• Anthropic SDK 相容層：官方的 legacy 端點頁（developers/rest-api-reference/inference/legacy）標示為 fully deprecated，請改用 Responses API 或 gRPC。

模型清單與價格

以下為文字與多模態模型，輸入可以是文字加圖片，輸出是文字。價格單位為 USD / 100 萬 token，查詢日 2026-11-06，出自 developers/models 與 developers/pricing（兩頁數字一致）。

長 context 加價：上表是 prompt 少於 200k token 的價格。prompt 達到 200k 以上時，整個請求的所有 token 都改用高價；各模型的高價剛好是上表每個數字的 2 倍（例如 grok-4.7 是輸入 $4.00、快取 $1.00、輸出 $12.00）。

其他模型頁的細節：

• 八個模型都支援 function calling 與 structured outputs。
• grok-4.7 模型頁寫明「No text output limit」。
• 別名規則：<model> 指最新穩定版，<model>-latest 指最新版，<model>-<date> 是釘住版本。例如 grok-4.20-0309-reasoning 也可寫成 grok-4.20，grok-build-0.1 的別名包含 grok-build-latest。
• Grok 4.7 Fast（同一模型、2 倍速、2 倍價；超長 context 為 1.5 倍）只在 Cursor 與 Grok Build 提供，不在公開 API。出自 developers/pricing。
• 圖片輸入支援 jpg、jpeg、png，單張上限 20 MiB，張數不限。presencePenalty、frequencyPenalty、stop 不能用在 reasoning 模型，帶了會回錯誤。

圖片、影片、語音模型另有計價，不在本章範圍。

Reasoning effort

reasoning_effort 控制模型回答前花多少力氣思考。出處：developers/model-capabilities/text/reasoning。

reasoning token 的計費方式與輸出 token 相同，用量中會以 reasoning_tokens 回報。推理內容不提供明文，只提供加密版本。

不同介面的寫法：Responses API 是 reasoning: {"effort": "high"}；xai-sdk 是 reasoning_effort="high"；Vercel AI SDK 是 providerOptions.xai.reasoningEffort。

官方 reasoning 頁的 curl 範例如下，其中 -m 3600 是把逾時拉長到 3600 秒，官方建議 reasoning 模型這樣做以免連線被提早關閉。

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -m 3600 \
  -d '{
    "model": "grok-4.7",
    "reasoning": {"effort": "high"},
    "input": [
        {
            "role": "system",
            "content": "You are a highly intelligent AI assistant."
        },
        {
            "role": "user",
            "content": "Find all prime numbers p such that p^2 + 2 is also prime. Prove your answer."
        }
    ]
}'

出處：docs.x.ai Reasoning（developers/model-capabilities/text/reasoning）。

官方頁面不一致的地方：

實務上的做法是以 GET /v1/models 回傳的 capabilities.reasoning_effort 為準，或只依賴 grok-4.7 與 grok-4.6 這兩個頁面一致的設定。grok-4.20-multi-agent 的 reasoning.effort 不是控制思考深度，而是控制協作的 agent 數量（4 個或 16 個），該模型為 beta，API 介面可能有破壞性變更。

已退役的模型

官方在 2026-05-15 12:00 PT 退役下列 slug。退役後 slug 仍可呼叫，請求會自動轉址，並按 grok-4.3 計價（輸入 $1.25、輸出 $2.50 / 100 萬 token），不是原模型的價格。出處：developers/migration/may-15-retirement。

grok-code-fast-1 在模型頁也列為 grok-build-0.1 的別名。官方文件沒有提到 grok-3-mini、grok-2 系列等更舊 slug 的狀態，目前的模型頁也不列這些模型。

網路上大量教學仍使用 grok-3、grok-4、grok-code-fast-1，照抄會被轉到 grok-4.3 並以不同價格計費；新專案請直接指定現行模型。

怎麼選模型

下面是依官方模型頁與 Release Notes 整理的差異，不是官方的選型建議。

各模型的上線時間，依 Release Notes 的月份標題：grok-4.20 在 2026 年 3 月、grok-build-0.1 在 5 月、grok-4.5 在 7 月（同月也對歐洲使用者開放）、grok-4.6 在 8 月、grok-4.7 在 9 月。

區域與資料保留

全球端點 https://api.x.ai 不保證請求在哪個地區處理，xAI 可能因為容量跨區路由。各模型頁的 Regions 欄位列出供應地區，例如 grok-4.7 與 grok-4.6 為 us-east-1、us-west-2、us-central-1，grok-4.3 為 us-east-1、eu-west-1、us-west-2，但這不等於路由保證。

要把處理限制在美國，可以改用 https://us.api.x.ai/v1。這個端點只提供 grok-4.7 與 grok-4.6，沒有圖片、影片與語音，token 用量加價 10%，而且官方明講這不是完整的資料落地保證，有合約需求請先洽 [email protected]。出處：developers/advanced-api-usage/regions。

資料保留方面，依 Security FAQ，預設所有 API 請求與回應會以加密形式存放在 xAI 伺服器 30 天，用於濫用稽核，之後自動刪除；未經你明確同意，xAI 不會拿 API 的輸入與輸出訓練模型。Zero Data Retention（ZDR）以 team 為單位開啟，但會停用有狀態的 Responses、Files、Collections、Batch 等功能，官方也不建議多數客戶開啟。

價格查詢日

本章所有價格的查詢日是 2026-11-06，來源為 docs.x.ai 的 Models 與 Pricing 頁。docs.x.ai 的頁面大多沒有顯示最後更新日期，只有 Release Notes 以月份分段。2026 年內文字模型已陸續新增 grok-4.20、grok-build-0.1、grok-4.3、grok-4.5、grok-4.6、grok-4.7，所以下單前請以 Console 的 Models 頁與 GET /v1/models 的回傳為準。

API 用量限制與計費

xAI API 的限制以 team 為單位，依累計消費自動分成 Tier 0 到 Tier 4。計費則分預付點數與月結發票兩種。本章數字是 2026-11-06 查詢的結果，出處為 docs.x.ai 的 Rate Limits（developers/rate-limits）、Pricing（developers/pricing）與 Manage Billing（console/billing）。

Rate limit 的算法

每個 team 對每個模型有兩個維度的上限：

• RPS：每秒請求數。官方說明每秒上限是由每分鐘請求預算推導（RPM 除以 48，最少 2），所以不能把一整分鐘的請求量集中在一秒內送出。
• TPM：每分鐘 token 數。

超過任何一項都會回 HTTP 429。計入 TPM 的包含 prompt token（文字、圖片、音訊）、completion token、reasoning token，以及快取過的 prompt token。快取 token 雖然計費較低，仍然佔用 TPM。

舊文章常寫的 RPM 數字不要沿用，現行文件的單位是 RPS 與 TPM。

Tier 與升級門檻

Tier 依 2026-01-01 起的累計 API 消費決定，消費達到門檻就自動升級，不需要申請。計算基礎是預付點數的購買金額，或已付款的發票。官方寫明升級後不會降級。

各 Tier 的限制

下表為 T0、T1、T2、T3、T4 的數值，出自 developers/rate-limits。

語音端點用 RPS 與並行連線數（官方稱 concurrent sessions）限制，不用 token：

補充說明：

• Tier 制適用於文字、embedding 與語音模型。Imagine API（圖片、影片）要提高上限，請寄信到 [email protected]。
• 你的 team 實際的限制可以在 Console 的 Models 頁查看。
• Batch API 的請求不計入 rate limit。
• 想提高上限但不想多花錢，或需要超過 Tier 4，可以在 Console 的 Models 頁送出調整申請；企業等級的容量洽 [email protected]。

預付點數與月結

官方的 Manage Billing 頁列出兩種計費方式：

幾個容易踩到的行為：

• 月結發票的額度（invoiced billing limit）預設是 $0。此時只會使用預付點數，點數用完後 API 請求會直接被拒絕。
• 開通月結後，系統先用預付點數，不足的部分月底從預設付款方式扣款；達到發票額度後，在調高額度前不會再有回應。
• 自動儲值（Auto top-up）：官方建議開啟以免服務中斷，可設定觸發的餘額門檻、單次儲值金額（最低 $5），以及每月儲值總額上限。用掉月上限的 80% 時，API spend management 卡片會顯示警告。
• 目前預付點數只能透過 Guest Checkout 購買，官方說明是法規因素。用銀行轉帳購買需 2 到 3 個工作天，到帳後才會發放點數。
• Billing 頁有 promo code 輸入欄，持有促銷碼的話可以在此使用。

SuperGrok 與 X 的消費型訂閱，和 API 點數是分開的，買了訂閱不會有 API 額度，反之亦然。

官方文件沒有免費額度

在 docs.x.ai 的 Billing、Pricing、Rate Limits 與 Quickstart 頁面中，沒有任何「免費額度」或「用資料分享換額度」的說法。Quickstart 的第一步就是註冊後先儲值。

網路上流傳過「新帳號贈送額度」「同意資料分享後每月獲得額度」之類的說法，不同第三方頁面互相矛盾，xAI 官方文件也都沒有出現。是否有任何額度，請以 Console 的 Billing 頁實際顯示為準，不要依據第三方的整理。

其他計費規則

Batch API：文字模型 -20%

Batch API 是非同步批次，多數請求在 24 小時內完成（官方未保證）。折扣適用於 grok-4.7、grok-4.6、grok-4.5、grok-4.3 與 grok-4.20 的三個模型，套用在輸入、輸出、快取與 reasoning token。grok-build-0.1 不支援 Batch。圖片與影片可以走 Batch，但依一般價計費。出處：developers/pricing、developers/advanced-api-usage/batch-api。

官方文件列出的限制：JSONL 上傳檔上限 200 MB；單一請求 payload 上限 25 MB；每個 team 每秒最多建立 2 個 batch；每 30 秒最多呼叫 1000 次 add-requests；超過 10 萬筆請求的批次可能被節流。啟用 ZDR（Zero Data Retention）的 team 不能使用 Batch。

建立 batch 的最小範例：

curl -X POST https://api.x.ai/v1/batches \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "name": "customer_feedback_analysis"
  }'

出處：docs.x.ai Batch API（developers/advanced-api-usage/batch-api）。後續加入請求與取回結果，見該頁的 Step 2 到 Step 4。

Priority Processing：2 倍費率

在文字端點（Responses、Chat Completions）加上 service_tier: "priority"，請求會得到較高的排程優先權，費率為標準價的 2 倍，輸入、輸出、快取與 reasoning token 都適用；快取折扣先計算，再乘以 2 倍。回應中的 service_tier 欄位會告知實際使用的層級，只有回應確認是 priority 才按 2 倍計費。不支援圖片、影片與 Batch。

response = client.responses.create(
    model="grok-4.7",
    input="Explain the Riemann hypothesis in one paragraph.",
    service_tier="priority",
)
print(response.output_text)
print(f"Tier used: {response.service_tier}")

出處：docs.x.ai Priority Processing（developers/advanced-api-usage/priority-processing）。範例中的 client 是第 9 章建立的 OpenAI SDK client。

違規費：違反使用規範的請求仍然會計費。在 Responses API 中、生成前就被攔截的請求，每個收 $0.05 的違規費。出處：developers/pricing。

美國區域端點：用 https://us.api.x.ai/v1 時，token 用量加價 10%（1.1 倍）。出處：developers/advanced-api-usage/regions。

費用試算

下面是依官方價格做的算術示意，實際金額以回應中的 usage.cost_in_usd_ticks 為準。假設在 grok-4.7 上送出一批 prompt 少於 200k token 的請求，共 100 萬輸入 token（無快取）與 10 萬輸出 token：

reasoning token 以輸出價計費，所以 reasoning effort 設得越高，輸出 token 越多，實際費用會比上表高。工具呼叫費用另計，見第 11 章。

追蹤每次請求的費用

每個回應的 usage.cost_in_usd_ticks 會回報該請求的實際費用，1 USD 等於 10,000,000,000 ticks，已包含快取折扣與工具費用。官方的 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.7",
    messages=[user("Say hello")],
)
response = chat.sample()

# Convenience property — ticks converted to dollars.
print(f"Cost: ${response.cost_usd:.6f}")

# Raw ticks for integer-precision accounting.
print(f"Cost (ticks): {response.usage.cost_in_usd_ticks}")

出處：docs.x.ai Cost Tracking（developers/cost-tracking）。

Prompt caching 會自動進行。官方建議在 Responses API 設定 prompt_cache_key（Chat Completions 則用 x-grok-conv-id header），讓同一段對話落在同一台機器；快取的 token 數可從 usage.input_tokens_details.cached_tokens 讀取。出處：developers/advanced-api-usage/prompt-caching。

遇到 429 該怎麼處理

官方的做法很簡單：實作指數退避（exponential backoff）。範例是每次失敗後依序等待 1、2、4、8 秒再重試（2 的 attempt 次方），達到重試上限就把錯誤丟出去。xai-sdk 使用 gRPC，對應的錯誤碼是 RESOURCE_EXHAUSTED。

官方 Rate Limits 頁的範例如下。這份範例呼叫的是 legacy 的 chat.completions，改成 client.responses.create 的退避邏輯完全相同。

import os
import time
from openai import OpenAI, RateLimitError

client = OpenAI(base_url="https://api.x.ai/v1", api_key=os.getenv("XAI_API_KEY"))

def request_with_backoff(messages, max_retries=5):
    for attempt in range(max_retries):
        try:
            return client.chat.completions.create(
                model="grok-4.7",
                messages=messages,
            )
        except RateLimitError:
            if attempt == max_retries - 1:
                raise
            wait = 2 ** attempt
            time.sleep(wait)

出處：docs.x.ai Rate Limits（developers/rate-limits）。

官方 Debugging 頁（developers/debugging）對 429 的建議是降低請求頻率，或到 Console 提高上限。處理 429 時可以依官方文件做這些事：

1. 先看 Models 頁，確認你的 Tier 與該模型的 RPS、TPM。
2. 記得快取 token 也計入 TPM，長 prompt 即使命中快取也會佔用額度。
3. 不需要即時結果的工作量改走 Batch API，Batch 不計入 rate limit。
4. 需要更高上限，從累計消費升級 Tier、在 Models 頁送出調整申請，或聯絡 [email protected]。

另外，Debugging 頁的錯誤碼表只列出 400、401、403、404、405、415、422、429，沒有 5xx 的條目，也沒有完整的錯誤 body 規格；服務狀態請看 status.x.ai。

文字生成、結構化輸出與內建工具

這章說明用 API 做文字生成的主要功能：Responses API、streaming、reasoning、structured outputs、function calling、圖片輸入，以及由 xAI 伺服器代為執行的內建工具。範例的出處都是 docs.x.ai 的對應頁面，模型一律用 grok-4.7；價格與限制是 2026-11-06 的查詢結果。

Responses API 與 Chat Completions

官方文件推薦使用 Responses API（/v1/responses），原有的 Chat Completions（/v1/chat/completions）被標為 legacy。出處：developers/model-capabilities/text/comparison、developers/model-capabilities/legacy/chat-completions。

參數對照：

回應內容的位置也不同：Chat Completions 在 choices[0].message.content，Responses API 在 output 陣列裡以型別區分的項目，SDK 的 output_text 是取純文字的便利屬性。

官方文件對 legacy 的措辭不一致：comparison 頁的表頭寫 Deprecated，chat-completions 頁寫「offered as a legacy endpoint」。兩處的建議相同，都是遷移到 Responses API。

伺服器端儲存：Responses API 預設會把 prompt、reasoning 與回應存在伺服器 30 天，帶 store: false 可以關閉。關閉儲存又使用 reasoning 模型時，可以用 include: ["reasoning.encrypted_content"] 取回加密的思考內容，下一輪原樣傳回；grok-4.7 不論有沒有 include 都會回傳。

多輪對話的官方範例如下。該頁面的原始範例使用的是已退役的 grok-4，這裡改成 grok-4.7。

# First request
response = client.responses.create(
    model="grok-4.7",
    input=[{"role": "user", "content": "What is 2+2?"}],
)

# Continue the conversation - no need to resend history
second_response = client.responses.create(
    model="grok-4.7",
    previous_response_id=response.id,
    input=[{"role": "user", "content": "Now multiply that by 10"}],
)

出處：docs.x.ai Comparison with Chat Completions API（developers/model-capabilities/text/comparison）。

Streaming

所有有文字輸出的模型都支援 streaming，圖片生成模型不支援。設定 "stream": true，伺服器以 SSE（Server-Sent Events）回傳增量內容。官方提醒：reasoning 模型建議手動拉長請求逾時，避免連線被提早關閉（官方範例用 3600 秒）。出處：developers/model-capabilities/text/streaming。

官方的 streaming 頁範例用的是 Chat Completions。Responses API 的 streaming 寫法出現在 Tools Overview（developers/tools/overview），同時帶了內建工具：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1",
)

response = client.responses.create(
    model="grok-4.7",
    input=[
        {"role": "user", "content": "What are the latest updates from xAI?"}
    ],
    tools=[
        {"type": "web_search"},
        {"type": "x_search"},
        {"type": "code_interpreter"},
    ],
    stream=True,
)

for event in response:
    if event.type == "response.output_text.delta":
        print(event.delta, end="", flush=True)

出處：docs.x.ai Tools Overview。官方範例的 prompt 原文是詢問該公司的最新動態，這裡改成較通用的寫法。

兩個實作上的注意事項：

• streaming 時，function call 會完整出現在單一 chunk，不會分段串流。
• 官方另有 WebSocket 模式（單一長連線，官方量測工具密集的 agent 迴圈最多約 20% 端到端延遲下降，與 ZDR、store=false 相容）與 Context Compaction API（縮短長對話的 context），分別見 developers/advanced-api-usage/websocket-mode 與 developers/advanced-api-usage/context-compaction。

Reasoning

reasoning.effort（Responses API）可選 low、medium、high（預設）、xhigh，各模型支援的範圍與官方頁面不一致之處，見第 9 章。reasoning token 以輸出價計費；推理內容只提供加密版本。

Structured outputs

structured outputs 讓回應嚴格符合你提供的 JSON Schema。出處：developers/model-capabilities/text/structured-outputs。

• Responses API 用 text.format；Chat Completions 用 response_format（json_schema、json_object、text）。
• 可以搭配 Pydantic（Python）或 Zod（JavaScript）定義 schema。
• function calling 的參數一律嚴格遵循 schema（strict 隱含為 true）。
• 可以和內建工具、function calling 一起用，得到「先用工具查資料、再回傳固定格式」的結果。

支援的 JSON Schema 是一個子集：

Python 搭配 Pydantic 與 web search 的官方範例：

import os
from openai import OpenAI
from pydantic import BaseModel, Field

class ProofInfo(BaseModel):
    name: str = Field(description="Name of the proof or paper")
    authors: str = Field(description="Authors of the proof")
    year: str = Field(description="Year published")
    summary: str = Field(description="Brief summary of the approach")

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1",
)

response = client.responses.parse(
    model="grok-4.7",
    input="Find the latest machine-checked proof of the four color theorem.",
    tools=[
        {"type": "web_search"}
    ],
    text_format=ProofInfo,
)

proof = response.output_parsed
print(f"Name: {proof.name}")
print(f"Authors: {proof.authors}")
print(f"Year: {proof.year}")
print(f"Summary: {proof.summary}")

出處：docs.x.ai Structured Outputs，Agentic Tools with Structured Output 一節。官方頁面把 ProofInfo 的定義與呼叫分開兩個區塊，這裡合併為一段。

Function calling

function calling 讓模型要求你的程式執行自訂函式。流程出自 developers/tools/function-calling：

1. 在 tools 定義函式的 name、description 與 JSON Schema 參數。
2. 模型回傳 function_call 項目。
3. 你的程式執行函式，用 function_call_output 加上 previous_response_id 把結果送回。
4. 模型根據結果產生最終回應。

tool_choice 可設 auto（預設）、required、none 或指定單一函式。平行呼叫預設開啟，模型可在一個回應內要求多個工具呼叫，要關閉就帶 parallel_tool_calls: false。Chat Completions reference 註明最多 128 個函式。function calling 可以和伺服器端的內建工具混用。

官方範例：

import os
import json
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1",
)

tools = [
    {
        "type": "function",
        "name": "get_temperature",
        "description": "Get current temperature for a location",
        "parameters": {
            "type": "object",
            "properties": {
                "location": {"type": "string", "description": "City name"},
                "unit": {"type": "string", "enum": ["celsius", "fahrenheit"], "default": "fahrenheit"}
            },
            "required": ["location"]
        },
    },
]

response = client.responses.create(
    model="grok-4.7",
    input=[{"role": "user", "content": "What is the temperature in San Francisco?"}],
    tools=tools,
)

# Handle function calls
for item in response.output:
    if item.type == "function_call":
        args = json.loads(item.arguments)
        result = {"location": args["location"], "temperature": 59, "unit": args.get("unit", "fahrenheit")}

        response = client.responses.create(
            model="grok-4.7",
            input=[{"type": "function_call_output", "call_id": item.call_id, "output": json.dumps(result)}],
            tools=tools,
            previous_response_id=response.id,
        )

for item in response.output:
    if item.type == "message":
        print(item.content[0].text)

出處：docs.x.ai Function Calling（developers/tools/function-calling）。

圖片輸入

在 Responses API 的 content 放 input_image 與 input_text。image_url 可以是公開 URL，或 data:image/jpeg;base64,... 形式的 base64。支援 jpg、jpeg、png，單張上限 20 MiB，張數沒有上限。圖片以 token 計費。出處：developers/model-capabilities/images/understanding。

response = client.responses.create(
    model="grok-4.7",
    input=[
        {
            "role": "user",
            "content": [
                {
                    "type": "input_image",
                    "image_url": image_url,
                    "detail": "high",
                },
                {
                    "type": "input_text",
                    "text": "What's in this image?",
                },
            ],
        },
    ],
)

出處：docs.x.ai Image Understanding。官方提醒：傳圖片時建議不要把請求與回應存在伺服器，否則可能失敗。

內建工具

內建工具在 xAI 的伺服器端執行，你只要在 tools 設定要用哪些工具，API 會自動執行並回傳結果與引用來源。官方的處理流程是：分析問題、決定要呼叫工具或直接回答、執行工具、整理結果並重複，直到資訊足夠，最後回傳含引用的回應。出處：developers/tools/overview。

內建工具 2025-10 正式推出（GA）。工具回應的 citations 屬性預設一定會回傳，列出 agent 在搜尋過程中遇到的所有來源 URL；另外還有嵌在回應文字中的 inline citations，見 developers/tools/citations。

費用 = token 用量 + 工具呼叫次數。 模型自己決定要呼叫幾次工具，所以問題越複雜，費用越高。以下為 developers/pricing 的工具價格。

補充：

• X Search 按「取回的筆數」計費，搜尋或串文取回所回傳的每一篇貼文（含父貼文與引用貼文）都算一篇，使用者搜尋回傳的每個個人檔案算一個。
• Image Search 屬於 Web Search，按 Web Search 的費率計。
• xai-sdk（gRPC）不支援 code_interpreter 與 file_search 這兩個別名，要用 code_execution 與 collections_search。
• 另外還有一般 token 費用：input、reasoning、completion、image 與快取 token，都依該請求使用的模型計價。

xai-sdk 與 Vercel AI SDK 的寫法不同，官方 Tools Overview 的 Vercel AI SDK 範例如下：

import { xai } from "@ai-sdk/xai";
import { streamText } from "ai";

const { fullStream } = streamText({
  model: xai.responses("grok-4.7"),
  prompt: "What are the latest updates from xAI?",
  tools: {
    web_search: xai.tools.webSearch(),
    x_search: xai.tools.xSearch(),
    code_execution: xai.tools.codeExecution(),
  },
});

for await (const part of fullStream) {
  if (part.type === "text-delta") {
    process.stdout.write(part.text);
  } else if (part.type === "source" && part.sourceType === "url") {
    console.log(`Citation: ${part.url}`);
  }
}

出處：docs.x.ai Tools Overview。同樣把 prompt 改成通用寫法。

Web Search

即時搜尋並瀏覽網頁。可用參數：allowed_domains（最多 5 個）、excluded_domains（最多 5 個，不能和 allowed_domains 同時使用）、enable_image_understanding（讓 agent 分析搜尋過程遇到的圖片）、enable_image_search（結果可嵌入圖片）。出處：developers/tools/web-search。

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
  "model": "grok-4.7",
  "input": [
    {
      "role": "user",
      "content": "What is xAI?"
    }
  ],
  "tools": [
    {
      "type": "web_search"
    }
  ]
}'

出處：docs.x.ai Web Search。原文的 prompt 是詢問公司名稱的簡單問題，這裡改寫。

X Search

搜尋 X 上的貼文、使用者與串文，支援關鍵字搜尋（可用 X 進階搜尋運算子）、語意搜尋、使用者搜尋與串文取回。參數包括 allowed_x_handles / excluded_x_handles（各最多 20 個；Vercel AI SDK 為 10 個）、from_date / to_date（YYYY-MM-DD）、enable_image_understanding、enable_video_understanding（預設 false）。出處：developers/tools/x-search。

import { xai } from "@ai-sdk/xai";
import { generateText } from "ai";

const { text, sources } = await generateText({
  model: xai.responses("grok-4.7"),
  prompt: "What are people saying about xAI on X?",
  tools: {
    x_search: xai.tools.xSearch(),
  },
});

console.log(text);
console.log("Citations:", sources);

出處：docs.x.ai X Search。原文 prompt 的公司名稱不同，這裡改寫。

Code Execution

讓 Grok 寫 Python 並在沙箱中執行，用於精確計算、資料分析與驗證。常見套件如 NumPy、Pandas、Matplotlib、SciPy 已預裝。沙箱沒有外部網路、檔案系統受限、跨請求不保留狀態，大型資料集可能碰到記憶體限制；官方頁面沒有公布具體的執行時間與記憶體數字。出處：developers/tools/code-execution。

工具名稱依介面不同：xAI SDK 是 code_execution，Responses API 是 code_interpreter，Vercel AI SDK 是 xai.tools.codeExecution()。

response = client.responses.create(
    model="grok-4.7",
    input=[
        {
            "role": "user",
            "content": "Calculate the compound interest for $10,000 at 5% annually for 10 years",
        },
    ],
    tools=[
        {
            "type": "code_interpreter",
        },
    ],
)

print(response)

出處：docs.x.ai Code Execution，Basic Calculations 一節，client 的建立方式同上面的 Responses 範例。

Collections 與 Files

兩者都是讓模型讀取你自己的文件，用途不同。出處：developers/files、developers/files/collections、developers/pricing。

Files 需要支援 agentic 工具的模型，官方列出 grok-4.20、grok-4.5、grok-4.6、grok-4.7，支援文字、程式碼、csv、json、pdf 等格式。啟用 ZDR 的 team 不能使用 Files 與 Collections。 查詢 Collections 的工具叫 collections_search（Responses API 也可寫 file_search），呼叫費為每 1000 次 $2.50。完整的建立 collection、上傳、查詢流程，見 developers/tools/collections-search。

Remote MCP

xAI 的伺服器替你連到外部的 MCP server，讓 Grok 使用其中的工具。出處：developers/tools/remote-mcp。

OpenAI Responses API 的 require_approval 與 connector_id 參數目前不支援。Remote MCP 也可用在 Speech to Speech API。工具呼叫本身不另外收費，只計 token。

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
  "model": "grok-4.7",
  "input": [
    {
      "role": "user",
      "content": "What can you do with https://github.com/xai-org/xai-sdk-python?"
    }
  ],
  "tools": [
    {
        "type": "mcp",
        "server_url": "https://mcp.deepwiki.com/mcp",
        "server_label": "deepwiki"
    }
  ]
}'

出處：docs.x.ai Remote MCP Tools。

Live Search 的現況

2025-05 的 Release Notes 寫明 Live Search 在 API 上線，也就是 Chat Completions 的 search_parameters 參數（mode、sources、from_date、to_date、max_search_results、return_citations）。目前 API reference 的 Chat Completions 仍保留這個參數，但導覽列已經沒有 Live Search 頁面，官方主推的是上述的 web_search 與 x_search 工具。官方文件沒有明確寫「Live Search 已棄用」，所以新專案建議直接用內建工具，舊的 search_parameters 視為 legacy 端點上的參數。出處：developers/release-notes、developers/rest-api-reference/inference/chat-completions。

圖片、影片與語音 API

Grok 的媒體能力分成兩組 API：Imagine API 負責圖片與影片生成，Voice API 負責即時語音對話（Speech to Speech）、文字轉語音（TTS）與語音轉文字（STT）。兩組都用同一把 XAI_API_KEY，不過各自有獨立的模型、端點與計價方式。本章內容以 2026-11-06 的 docs.x.ai 頁面為準，模型與價格更新很快，動手前請對照官方頁面。

兩個先決條件：

• 美國區域端點（us.api.x.ai）不提供圖片、影片與語音，這三類只能走全球端點 https://api.x.ai，區域端點的說明見下一章。
• 開啟 Zero Data Retention（ZDR）時，圖片與影片不能由 xAI 代為存放，必須自備上傳網址，見本章「圖片」與「影片」兩節。

Imagine API 概覽

出處：docs.x.ai「Imagine Overview」（/developers/model-capabilities/imagine）。

圖片生成

出處：docs.x.ai「Image Generation」與「Imagine Overview」。目前的主力模型是 grok-imagine-image-2.0，舊的 grok-imagine-image（1.0）仍可使用。

最小的請求：

curl -X POST https://api.x.ai/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "A collage of London landmarks in a stenciled street-art style"
  }'

常用參數：

幾個容易漏看的行為：

• 回傳的網址是暫時性的，要儘快下載。
• quality 為 auto 時，生成使用 low，編輯使用 medium，並依實際服務的品質計費。
• 官方 2026-11 的公告指出，grok-imagine-image-quality 與 grok-imagine-image-pro 兩個名稱已退役，請求會自動轉由 grok-imagine-image-2.0 搭配 quality: "low" 處理，不必改程式。
• 同一個提示詞要多個版本時，官方建議用 n，比重複送請求有效率。

圖片編輯

出處：docs.x.ai「Imagine Overview」。來源圖可以是公開網址或 base64 data URI，單次最多 5 張，可用來合成主體、轉換風格或組合場景。

curl -X POST https://api.x.ai/v1/images/edits \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "Render this as a pencil sketch with detailed shading",
    "image": {
      "url": "https://docs.x.ai/assets/api-examples/images/style-realistic.png",
      "type": "image_url"
    }
  }'

影片生成

出處：docs.x.ai「Video Generation」。影片請求是非同步的：先送出請求拿到 request_id，再輪詢到狀態為 done。xAI SDK 與 Vercel AI SDK 會自動輪詢。

請求模式：

設定範圍：duration 為 1 到 15 秒（預設 8）；resolution 可選 480p、720p、1080p，預設是 480p；長寬比支援 1:1、16:9、9:16、4:3、3:4、3:2、2:3、21:9、5:2，預設 16:9。影片預設帶音軌，傳 generate_audio: false 可取得無聲影片。

輪詢的完整寫法（出處：docs.x.ai「Imagine Overview」）：

# Start the video generation request
REQUEST_ID=$(curl -s -X POST https://api.x.ai/v1/videos/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "Make the water crash down and slowly pan out the camera",
    "image": {"url": "https://docs.x.ai/assets/api-examples/video/waterfall-still.png"},
    "duration": 12
  }' | jq -r '.request_id')

# Poll until the video is ready
while true; do
  RESULT=$(curl -s https://api.x.ai/v1/videos/$REQUEST_ID \
    -H "Authorization: Bearer $XAI_API_KEY")
  STATUS=$(echo "$RESULT" | jq -r '.status')
  if [ "$STATUS" = "done" ]; then
    echo "$RESULT" | jq -r '.video.url'
    break
  elif [ "$STATUS" = "failed" ] || [ "$STATUS" = "expired" ]; then
    echo "Request $STATUS"; echo "$RESULT" | jq .
    break
  fi
  sleep 5
done

失敗時的 error.code（出處：「Video Generation」的 Error Handling）：

Imagine 的價格與限制

出處：docs.x.ai「Pricing」「Rate Limits」與 2026-11 的遷移公告。

補充三點：

• 遷移公告列出 grok-imagine-image-2.0 在 low 品質下，1K 為 $0.04、2K 為 $0.06，編輯時每張輸入圖另加 $0.01；medium 品質的單價在官方頁面沒有列出，請以價格頁與回應中的 usage.cost_in_usd_ticks 為準。
• 官方在 Imagine 概覽寫「影片的時長與解析度都會影響費用」，但價格頁只列單一的每秒價格；兩處說法不完全一致，實際費用以回應中的用量欄位為準。
• Imagine 的 Rate limit 不適用 Tier 自動升級，要提高額度需寄信給 [email protected]。基準值（Tier 0 到 Tier 4，每秒請求數）：圖片模型 6、12、25、50、100；影片模型 10、20、39、79、158。

Voice API 概覽

出處：docs.x.ai「Voice Overview」。

Speech to Speech：即時語音 agent

出處：docs.x.ai「Speech to Speech」與「Voice Overview」。

連線網址是 wss://api.x.ai/v1/realtime?model=grok-voice-latest。grok-voice-latest 是別名，現在指向 grok-voice-3.0；grok-voice-2.0 已標為棄用，API 不變、價格相同。

import asyncio
import json
import os
import websockets

async def voice_agent():
    async with websockets.connect(
        "wss://api.x.ai/v1/realtime?model=grok-voice-latest",
        additional_headers={"Authorization": f"Bearer {os.environ['XAI_API_KEY']}"}
    ) as ws:
        # Configure voice and enable tools
        await ws.send(json.dumps({
            "type": "session.update",
            "session": {
                "voice": "eve",
                "instructions": "You are a helpful customer support agent.",
                "turn_detection": {"type": "server_vad"},
                "tools": [{"type": "web_search"}]
            }
        }))

        # Stream audio and receive responses
        async for message in ws:
            event = json.loads(message)
            if event["type"] == "response.output_audio.delta":
                # Play audio: base64.b64decode(event["delta"])
                pass

asyncio.run(voice_agent())

session.update 的常用欄位：

瀏覽器與手機端不要放 API key，官方建議用 Ephemeral Tokens：由你的伺服器向 POST https://api.x.ai/v1/realtime/client_secrets 換一個短效 token 交給用戶端（出處：docs.x.ai「Ephemeral Tokens」）：

curl --url https://api.x.ai/v1/realtime/client_secrets \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  --data '{
    "expires_after": {
      "seconds": 300
    }
  }'

電話場景可透過 SIP 把 PSTN 或 PBX 來電接進 session，也有 Twilio、WebRTC 與 iOS 的範例專案放在 xai-cookbook。並行連線數依 Tier 而定：Tier 0 到 Tier 4 依序是 10、20、50、100、200 條。

Text to Speech

出處：docs.x.ai「Text to Speech」。

curl -X POST https://api.x.ai/v1/tts \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Welcome to our service. How can I help you today?",
    "voice_id": "eve",
    "language": "en"
  }' \
  --output welcome.mp3

（範例的文字已改為通用句子，其餘欄位照官方。）

文字裡可以插入 speech tag 控制語氣：行內標籤如 [pause]、[laugh]，包覆標籤如 <whisper>…</whisper>。WebSocket 串流端點（wss://api.x.ai/v1/tts）沒有文字長度上限，每個 team 同時最多 50 個 session。

Custom Voices 可以用最長 120 秒的參考音訊複製聲音（出處：docs.x.ai「Custom Voices」）：

• 官方建議使用 90 到 120 秒、安靜環境、單一說話者的錄音；少於 30 秒的素材細節可能不足。
• 在 Console 可免費建立最多 30 個自訂聲音；透過 API（POST /v1/custom-voices）建立則限 Enterprise 方案。
• 官方警示：Custom Voices 目前只在美國提供，伊利諾州除外。

Speech to Text

出處：docs.x.ai「Speech to Text」。預設模型為 grok-voice-transcribe-2.0；舊的 1.0 已於 2026-10-02 結束，請求會自動轉到 2.0。

curl -X POST https://api.x.ai/v1/stt \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -F model=grok-voice-transcribe-2.0 \
  -F [email protected]

multipart 欄位的順序有規定：file 必須放在最後，否則前面的選項可能被忽略。串流辨識走 wss://api.x.ai/v1/stt，音訊以二進位 frame 傳送，設定放在網址參數。STT 的狀態碼除了 400、401、413、429，還有 502（用 url 下載失敗）與 503（後端暫時不可用）。

語言支援

STT 的語言數量在官方頁面不一致：STT 頁與 Voice Overview 寫 38 種以上，Release Notes 的發佈公告寫 25 種，x.ai/voice 行銷頁寫 25 種以上。STT 頁有逐一列出代碼的表格，內容較新較完整，實際可用的語言請以該表為準。

與華語使用者相關的部分：

繁體中文的支援程度，官方未公布。 TTS 與 Speech to Speech 的語言表只列簡體，STT 的表只列 Mandarin，沒有任何一頁說明輸出會是繁體字、是否支援台灣口音或台灣慣用詞彙。要用在正式產品前，建議自備繁體中文的文稿與錄音實測，再決定是否上線。

語音的 Rate limit

出處：docs.x.ai「Rate Limits」，Tier 0 到 Tier 4 依序列出。

Tier 依 2026-01-01 起的累計 API 消費自動升級，各 Tier 的消費門檻見 docs.x.ai「Rate Limits」。

開發工具、錯誤碼與企業功能

這一章分三塊：把 Grok 接進開發工具與雲端平台的方式、API 的錯誤碼，以及資料保留、區域、合規這些企業會問的事。內容以 2026-11-06 的 docs.x.ai 頁面為準；官方文件把公司稱為 SpaceXSI，但網域、環境變數與 SDK 仍沿用 xAI，本章統一寫 xAI。

開發工具總覽

Cline、Roo Code、Continue 這類工具大多支援 OpenAI 相容的 base URL，理論上可以填入 https://api.x.ai/v1；但這是推測，不是官方背書，xAI 沒有為它們提供設定說明。

Grok Build CLI

出處：docs.x.ai「Grok Build」「CLI Reference」「Headless & Scripting」。Grok Build 是 xAI 的 coding agent，可以用互動式 TUI、無頭模式（腳本與 bot），或透過 Agent Client Protocol（ACP）嵌入其他應用。Release Notes 把它列在 2026-05，標為 beta。

安裝與啟動：

curl -fsSL https://x.ai/cli/install.sh | bash

Windows 用 irm https://x.ai/cli/install.ps1 | iex。第三種是 npm 套件 @xai-official/grok（npm install -g @xai-official/grok），官方的企業部署頁特別指出，限制外連的環境可以用 npm 安裝，不必開放 x.ai。2026-11-06 查詢 npm registry，latest 版本是 1.0.77。

第一次執行 grok 會開瀏覽器登入；沒有瀏覽器的環境（SSH、容器）用 grok login --device-auth，或設定 XAI_API_KEY。

cd your-project
grok

無頭模式：

grok -p "Explain this codebase"
grok -p "Explain the architecture" --output-format streaming-json

輸出格式有 plain、json、streaming-json 三種。要在 IDE 或其他程式中當作 ACP agent 使用，指令是 grok agent stdio。在 CI 裡建議加 --no-auto-update，避免背景檢查更新。

常用子指令：

讀取 Claude Code 的設定

官方文件有一節「Claude Code compatibility」，寫明 Grok Build 不需任何設定，會自動讀取 Claude Code 的 marketplaces、plugins、skills、MCP、agents、hooks，以及 CLAUDE.md、CLAUDE.local.md 與 .claude/rules/，和 .grok/ 放在一起處理；也會讀 AGENTS.md 系列檔案，以及 Cursor 的 rules、MCP 與 hooks。

幾個實際的細節：

• MCP 設定會從 ~/.claude.json、.cursor/mcp.json 與專案的 .mcp.json 載入，優先序低於 config.toml。
• 要關掉某個來源，可在 ~/.grok/config.toml 設 [compat.claude] 或 [compat.cursor] 底下的 skills、rules、agents、mcps、hooks 為 false，也能用 GROK_CLAUDE_SKILLS_ENABLED=0 之類的環境變數。
• 部分 Claude Code 的旗標名稱可當別名使用：--allowedTools、--disallowedTools、--append-system-prompt、--system-prompt、--dangerously-skip-permissions。
• 企業部署若已用 MDM 發放 Claude Code 的 managed-settings.json，Grok 會讀其中的權限規則、MCP 允許清單與 marketplace 限制；但 disableBypassPermissionsMode 不會套用到 Grok，要鎖定 always-approve 必須在 Grok 自己的 requirements.toml 設 disable_bypass_permissions_mode = true。
• 這是「相容讀取」，不是在 Claude Code 裡呼叫 Grok；官方沒有「在 Claude Code 中使用 Grok 模型」的文件。

模型、MCP 與費用

• 模型：~/.grok/config.toml 的範例檔把預設模型設為 grok-build，也可用 [model.<id>] 加上 base_url、env_key 接任何相容端點，再用 grok -p "Hello" -m my-model 或 TUI 的 /model 切換。
• MCP：grok mcp add --transport http linear https://mcp.linear.app/mcp 加遠端 server；本機 server 用 grok mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/dir；加 --scope project 會寫入專案的 .grok/config.toml。
• 費用：Grok 4.7 Fast（同一個模型、兩倍速、兩倍價）只在 Cursor 與 Grok Build 提供，不在公開 API；官方明說它「不含在 Grok Build 的免費層」，也就是 Grok Build 有免費層，但免費層的額度與條件，官方頁面都沒有公布。付費用量走 The X Subscription 的方案。

Cursor

出處：docs.x.ai「Grok 4.7」與「The X Subscription」。官方模型頁寫 grok-4.7 在 Cursor「所有方案」都能使用。The X Subscription 把 Grok、Cursor 與 X 合成一份訂閱，Grok 與 Cursor 的第一方用量共用每週額度；在 Cursor 內使用第三方模型（例如 Claude、GPT）不含在額度內，從第一次使用起就依 API 牌價計費。

Vercel AI SDK

出處：docs.x.ai「Community Integrations」。安裝指令為 npm install ai @ai-sdk/xai zod，預設讀取環境變數 XAI_API_KEY。

import { xai } from '@ai-sdk/xai';
import { generateText } from 'ai';

const { text } = await generateText({
    model: xai.responses('grok-4.7'),
    prompt: 'Write a vegetarian lasagna recipe for 4 people.',
});

要指定金鑰或 base URL 時用 createXai({ apiKey, baseURL })；圖片則用 generateImage 搭配 xai.image('grok-imagine-image-2.0')。

LiteLLM

出處：docs.x.ai「Community Integrations」。模型名稱加上 xai/ 前綴：

from litellm import completion
import os

os.environ['XAI_API_KEY'] = ""
response = completion(
    model="xai/grok-4.7",
    messages=[
        {
            "role": "user",
            "content": "What's the weather like in Boston today in Fahrenheit?",
        }
    ],
    max_tokens=10,
    response_format={ "type": "json_object" },
    seed=123,
    temperature=0.2,
    top_p=0.9,
    user="user",
)
print(response)

這份官方範例走 Chat Completions 形式的 completion；xAI 的主要介面是 Responses API，LiteLLM 是否支援，請看 LiteLLM 自己的 xAI provider 文件。

Docs MCP Server

出處：docs.x.ai「Docs MCP Server」。xAI 提供一個讓 AI 助理直接查文件的 MCP server，網址 https://docs.x.ai/api/mcp，使用 Streamable HTTP、無狀態，工具包含 list_doc_pages、get_doc_page、search_docs。官方列出的設定方式涵蓋 Grok Build、Cursor、Zed、Windsurf 與 OpenCode。

grok mcp add --transport http xai-docs https://docs.x.ai/api/mcp
grok mcp doctor xai-docs

Cursor 則在 Settings → MCP 新增，類型選 url，填上同一個網址。

Vertex AI、Foundry 與模型閘道

Google Cloud Vertex AI（出處：docs.x.ai「Google Cloud Vertex AI」）：Grok 是 Model Garden 的 partner 模型，需先在 Model Garden 啟用，之後用 OpenAI 相容介面呼叫，支援 Responses API 與 Chat Completions。模型名稱帶發佈者前綴，例如 xai/grok-4.7；認證用 Application Default Credentials。資料保留與處理依 Google Cloud 的政策，而非 xAI 的 30 天規則。官方範例的 base URL 要照模型卡片或 Google 文件填寫，頁面沒有給固定值。

from openai import OpenAI

client = OpenAI()  # Uses ADC / env vars automatically

response = client.responses.create(
    model="xai/grok-4.7",
    input="Explain the advantages of using Grok for agentic workflows with parallel tool calling.",
    max_output_tokens=800,
)

print(response.output_text)

Microsoft Foundry（出處：docs.x.ai「Microsoft Foundry」）：先建立 Foundry resource 與 project，再從模型目錄部署 Grok 模型；「部署名稱」就是 model 參數的值，建立後不能更改。部署類型可選 Serverless（用多少付多少）或 Provisioned Throughput Units。費用走 Azure Marketplace 與你的 Azure 訂閱。端點格式為 https://{resource-name}.services.ai.azure.com/api/projects/{project-name}/openai/v1，官方建議用 Microsoft Entra ID 認證，也支援金鑰。

from azure.identity import DefaultAzureCredential, get_bearer_token_provider
from openai import OpenAI

project_endpoint = "https://YOUR-RESOURCE-NAME.services.ai.azure.com/api/projects/YOUR_PROJECT_NAME"
base_url = project_endpoint.rstrip("/") + "/openai/v1"

credential = DefaultAzureCredential()
token_provider = get_bearer_token_provider(
    credential,
    "https://ai.azure.com/.default",
)

client = OpenAI(
    base_url=base_url,
    api_key=token_provider,
)

response = client.responses.create(
    model="grok-4.3",  # your deployment name
    input="Explain the significance of Grok's tool-calling capabilities for building reliable agents. Be concise but insightful.",
    max_output_tokens=800,
)
print(response.output_text)

這頁還提到 Foundry 上的 Grok 可搭配 azure-ai-projects、LangChain、Semantic Kernel、LlamaIndex；這是 Foundry 頁面的說法，不等於 xAI 另有 LangChain 專頁。

模型閘道：grok-4.7 模型頁列出 OpenRouter、Vercel 與 Cloudflare 三個閘道，頁面只有名稱，沒有設定說明。安全 FAQ 另提醒，經由 OpenRouter 這類閘道共用一把 key 時，請替每位終端使用者帶不同的 safety_identifier，違規時才能歸因到個別使用者。

錯誤碼

出處：docs.x.ai「Debugging Errors」。API 失敗時通常回傳 HTTP 狀態碼與錯誤訊息，大部分訊息本身就說明了原因。

幾點補充：

• 官方的錯誤碼頁沒有任何 5xx 條目，也沒有錯誤回應 body 的完整規格。 要處理 5xx，只能參考各端點頁面，例如 TTS 與 STT 頁各自列了 500、502、503 並建議退避重試；影片生成的失敗代碼見上一章。
• 404 也代表「模型不存在，或你的 team 沒有存取權」，body 範例：{"code":"not-found","error":"The model ... does not exist or your team <team_id> does not have access to it..."}。在美國區域端點請求不在清單內的模型（包含已退役的 slug 與 grok-latest），也會得到這個 404。
• 沒帶金鑰直接呼叫 https://api.x.ai/v1/models 會得到 401，body 為 {"code":"unauthenticated:no-credentials",...}。
• xAI SDK 走 gRPC，429 會對應到 RESOURCE_EXHAUSTED。
• 服務狀態看 https://status.x.ai（也有 https://status.x.ai/feed.xml 的 RSS）；回報 bug 寄 [email protected]，附上請求、回應與相關記錄，或到 xAI API Developer Discord 的 #help。

資料保留與不訓練

出處：docs.x.ai「Security」FAQ。

• 預設：所有 API 請求與回應以加密形式存放在 xAI 伺服器 30 天，用途是濫用稽核，之後自動刪除。
• 不訓練：官方明確寫 xAI 未經你的明確同意，不會拿 API 的輸入與輸出訓練模型。
• Responses API 的伺服器端對話狀態同樣保留 30 天，傳 store: false 可關閉。
• team 管理員可在 Console 的 Audit Log 查看操作記錄；開啟 ZDR 後，記錄只含管理事件（例如建立 key、變更 team），不含請求與回應內容。

ZDR 的取捨

Zero Data Retention（ZDR）讓提示與輸出不寫入磁碟。官方文件對它的態度很謹慎：「大多數客戶不建議開啟」，因為 ZDR 會停用依賴儲存的功能，而且 ZDR 下刪除的內容，xAI 之後無法復原或提供。

操作面的限制：

• ZDR 以 team 為單位，不能只對單一 key 開啟。
• 由 team admin 在 Console 的 Team Settings 自助開關，開啟前必須先刪光既有的 Files 與 Collections。
• 開啟後，每個回應的 header 會帶 x-zero-data-retention: "true"，程式可據此確認。
• 看不到 ZDR 選項時，可能是因為你不是 admin、環境尚未開放自助 ZDR，或你的 team 在簽訂的 Enterprise 合約下另有約定，請聯絡 [email protected]。

在 Grok Build CLI 中，開啟 ZDR 時不保留 trace 或程式碼資料；沒開 ZDR 時，可用 /privacy 或 /settings 關閉程式碼資料的保留，首次使用也會詢問是否允許保留資料以改進產品與模型。ZDR 下 Grok Build 的影片工具需要自備 S3 相容的儲存空間，設定在 ~/.grok/managed_config.toml，未設定前影片工具會回報錯誤。

另外，grok.com 的 Build 模式為了跨 session 發佈 App，會保留對話與 build session，且不提供 Private Chat；若開啟「improve the model」，這些資料可能用於產品與模型改進。

美國區域端點

出處：docs.x.ai「Regional Endpoints」。全球端點 https://api.x.ai 不保證處理地區，xAI 可能因容量或可靠性在區域間調度。需要把請求處理與推論留在美國時，改用 https://us.api.x.ai/v1，所有 team 都能用，現有的 API key 通用。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://us.api.x.ai/v1",
)

response = client.responses.create(
    model="grok-4.7",
    input="Explain latency versus throughput in two sentences.",
)

print(response.output_text)

官方的警告很直接：區域端點本身不是完整的資料落地保證，有合約層級的處理或儲存地點要求，請在依賴它之前先聯絡 [email protected]。至於歐洲，API 文件沒有 EU 區域端點的專頁；部分模型頁的 Regions 欄位列出 eu-west-1 等節點，但官方明說那不是 API 路由保證。

mTLS

出處：docs.x.ai「mTLS Authentication」。mTLS 是企業功能，用來確保只有出示有效用戶端憑證的機器，才能代表你的 team 呼叫 API。

1. 寄信到 [email protected]，提供 team ID、PEM 格式的 CA 憑證，以及用戶端憑證的 Common Name。
2. 啟用後，把網址從 https://api.x.ai 換成 https://mtls.api.x.ai，API 路徑不變。
3. 每個請求都附上用戶端憑證與私鑰，原本的 API key 仍然要帶。

curl https://mtls.api.x.ai/v1/chat/completions \
  --cert /path/to/client-cert.pem \
  --key /path/to/client-key.pem \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{ ... }'

（官方範例在此使用 Chat Completions；其餘 API 路徑與功能啟用 mTLS 後行為相同。請求本文省略。）

合規認證

出處：docs.x.ai「Security」FAQ 與各模型功能頁。

GDPR 這類需要書面證明的事，不要只依賴文件頁面上的一句行銷用語，建議直接索取 DPA 與 Trust Center 資料，或聯絡 [email protected]（客製價格、月結發票與更高的 rate limit 也走這個管道，亦可填 https://x.ai/grok/business 的表單）。

Grok Build 的企業部署還有幾項控制：OIDC 單一登入（支援 Entra ID、Okta、Auth0）、MDM 發放的 /etc/grok/requirements.toml 強制設定、force_login_team_uuid 鎖定登入的 team、網路白名單（核心功能需要 cli-chat-proxy.grok.com 與 auth.x.ai），連線全程使用 TLS 1.2 或 1.3。

政府採購：GSA OneGov

xAI 的 docs.x.ai 沒有政府方案專頁。可以確認的一手資料來自美國 GSA（General Services Administration）2025-09-25 的新聞稿《GSA and xAI Partner on $0.42 per Agency Agreement to Accelerate Federal AI Adoption》（https://www.gsa.gov/node/166722），內容如下：

• 聯邦機關能以每個機構 $0.42 的價格取得 Grok 模型。
• 期限 18 個月，有效到 2027-03，GSA 稱這是 OneGov AI 協議中最長的期限。
• 協議涵蓋的模型是 Grok 4 與 Grok 4 Fast。
• xAI 承諾派駐專屬工程師協助機關導入，並提供入門訓練。
• 協議提供升級到符合 FedRAMP 與 DoD Impact Level 的 Grok 企業訂閱的路徑，以取得更多功能與更高的 rate limit。

這份新聞稿寫的是簽約當時的模型。Grok 4 與 Grok 4 Fast 的 API 名稱已在 2026-05-15 退役，請求自動轉址到 grok-4.3，之後協議涵蓋的模型是否更新，GSA 該頁沒有說明；FedRAMP 與 DoD IL 的授權現況，也不在 xAI 的 API 文件裡，需要的機關請直接向 xAI 與 GSA 確認。

與 ChatGPT、Claude、Gemini 的定位差異與資料來源

這一章只寫有官方頁面可以驗證的產品結構與政策差異，不評斷哪一家比較準、比較安全、比較好用。各家公開的 benchmark 與排名都是自家發佈，本指南不拿來比較。Claude 與 Gemini 的方案、價格與用量規則，請直接查各家官方頁面；本章不引用它們的數字，避免與頻繁調整的頁面脫節。

Grok 官方強調的幾件事

與 ChatGPT：價格階梯

美元價來自各家官方定價頁，新台幣是參考價：Grok 的數字取自 grok.com/plans 在 2026-11-06 的顯示，ChatGPT 的數字取自同日查詢的 ChatGPT 官方頁面。促銷與 App 內購價可能不同。

Grok 官方的說法是，Premium 相當於原本 SuperGrok、Cursor Pro 與 X Premium+ 合計 $90 美元每月的組合。這是官方對自家舊方案的換算，不代表與其他公司產品的等值比較。

幾個有依據的觀察

1. Grok 把訂閱綁在 X 與 Cursor 上。 The X Subscription 的方案同時包含 X 側的權益（勾勾、廣告、創作者工具等）和 Cursor。這是 Grok 方案結構的特點；選擇時要把「我是否需要 X 的權益」一併算進去。第三方模型（例如 Cursor 內的 Claude、GPT）不含在方案內，按 API 牌價另計。
2. 即時 X 資料是官方明確寫出的賣點。 Grok 官方頁面把「搜尋公開 X 貼文」寫成功能說明，並說明回答附引用。X 上的公開貼文能被引用，也代表你自己的公開貼文可能出現在 Grok 的回答裡；想避免，官方的做法是把帳號設為保護貼文。
3. 圖片與影片與對話在同一個入口。 Imagine 可從 grok.com/imagine 或對話串使用，影片支援參考圖與聲音參考。生成物帶浮水印，並禁止移除，這點在使用前要先接受。
4. Grok Bot 與 grok.com 是兩個產品。 官方 FAQ 明講兩者不同，登入帳號（Cursor）、用量計算（新方案吃共用池、舊方案獨立）與模型選擇（Grok Bot 沒有模型選單）都不同。比較「Grok」與其他產品的 agent 功能時，要先分清楚比的是哪一個。
5. 用量規則各家不同，而且都在變。 Grok 的每週共用用量池是 2026 年 6 月起逐步上線的新制，不要用 2025 年的「Chat 每天幾則、Imagine 每天幾張」去算。
6. 訓練預設。 消費者帳號的內容預設可能用於訓練，可在 Data Controls 關閉，Private Chat 不訓練；Business 與 Enterprise 不使用客戶內容訓練。與其他產品的預設是否相同，請各自對照其官方隱私說明。
7. 官方文件明文承認輸出可能不適當。 Grok 的官方 FAQ 與條款寫明輸出可能含粗話、粗俗幽默、性情境或暴力，澳洲條款另提到可限制接觸 18+ 媒體的設定（見下節）。

官方自報的數據

Grok 官方發佈的模型與排名，是廠商自己的聲明，本指南只轉述、不背書：

• Grok 4.7（2026-09-21）：官方稱為「most powerful model for coding and knowledge work」，知識截止 2026 年 5 月，context 為 500k。
• Grok 4.5（2026-07）：官方稱為「our most intelligent model yet」。
• Imagine Image 2.0：官方公告引用 Arena 的 Image Edit 與 Text-to-Image 排行榜（截至 2026-08-07），稱在兩項都排世界第二。公告並註明 xAI 的模型在 Arena 上以「SpaceXAI」名稱列出。

Grok 4.7 是否已在 grok.com 的一般對話預設啟用，官方公告只寫在 Cursor、Grok Build 與 API 可用，grok.com 側的對應官方未公布；請登入後在 app 內確認。

內容政策：只看官方文字

Grok 過往有許多媒體報導與社群討論的內容爭議。本章不收錄媒體報導或第三方評論，只列官方文件中可以直接引用的政策文字：

這些是政策文字，不等於實際執行效果。官方的 FAQ 也承認 Grok 可能出現不準確的資訊或幻覺，建議使用者查證。

怎麼選

• 需要查 X 上的即時討論：這是 Grok 官方明確寫出的功能，值得實際用自己關心的主題試一輪。
• 已經在用 Cursor 或 X Premium：The X Subscription 把它們綁在一起，要算清楚合併後的費用與新舊方案的切換規則；切換不可逆，客服無法還原。
• 想要長時間自動處理雜務的 agent：先確認自己要的是 grok.com 內的 Automations、Skills，還是獨立的 Grok Bot，三者用量與方案都不同。
• 重視資料不被拿去訓練：先關閉 Improve the model，敏感內容用 Private Chat；若在 X 內使用 Grok，另外到 X 設定關閉。企業用途則看 Business 或 Enterprise 的條款。
• 要做商業圖片或影片：先接受浮水印規則，並讀過輸出權利與標示的要求。

不論選哪一家，額度與方案在一兩個月內就可能調整。選定前，回官方頁面確認當下的條件。

資料來源

以下皆為官方頁面，查詢日 2026-11-06。官方頁面會持續更新，內容以各頁當下顯示為準。

公司與產品公告（x.ai/news）

• xAI joins SpaceX
• The X Subscription
• Grok 4.5、Grok 4.5 在 grok.com、X、iOS、Android
• Grok 4.6、Grok 4.7
• Introducing Grok Bot、Grok Bot 擴大方案、Grok Bot 與 X
• Connectors、Skills、Automations
• Build Mode、Grok Build on web and mobile
• Imagine Image 2.0、Imagine Video 1.5 with References
• Grok Voice 3.0、Grok Business
• 新聞列表（Office add-in 等各則公告）

產品與價格頁

• x.ai/grok、x.ai/grok/business、x.ai/bot、x.ai/build
• x.ai/pricing
• grok.com/plans（新台幣顯示）
• The X Subscription 定價說明、總覽

說明文件（docs.x.ai）

• Grok 總覽、Grok FAQ、Business 使用指南
• Connectors
• Grok Bot 總覽
• 模型、Release Notes

法律與政策

• Terms of Service
• Privacy Policy
• Consumer FAQs
• Acceptable Use Policy
• Safety
• Privacy Portal

X 與商店頁面

• About Grok（X Help Center）
• X Premium（X Help Center）
• Grok 的 iOS App Store 頁面
• Grok 的 Google Play 頁面

對照用：ChatGPT

ChatGPT 的方案與價格對照取自同日查詢的 ChatGPT 官方定價頁。