跳轉到主要內容
xAI Grok 是一款非常強大的 AI 對話系統，只要輸入提示詞，就能在短短幾秒內生成流暢自然的回覆。Grok 以其獨特的幽默風格和即時網路資訊獲取能力在業界獨樹一幟，如今，Grok 已在多個創新領域嶄露頭角，其影響力正快速擴大。無論是日常對話、創意寫作，還是技術分析、程式碼除錯，Grok 都能提供富有洞察力的智能協助，為用戶的決策和創作帶來全新維度的支持。 本文檔主要介紹 Grok Chat Completion API 操作的使用流程，利用它我們可以輕鬆使用官方 Grok 的對話功能。

​
申請流程

要使用 Grok Chat Completion API，首先到 Ace Data Cloud 控制台 獲取您的 API Token，留作備用。 如果你尚未登入或註冊，會自動跳轉到登入頁面邀請你註冊和登入，完成後會自動返回當前頁面。 一個 API Token 即可調用平台所有服務，無需為每個服務單獨申請。 首次申請會贈送免費額度，可免費體驗；額度不足時可在 控制台 充值通用餘額。
📘 完整文檔：Grok Chat Completion API →

​
基本使用

接下來就可以在介面上填寫對應的內容，如圖所示：

在第一次使用該介面時，我們至少需要填寫三個內容，一個是 authorization，直接在下拉列表裡面選擇即可。另一個參數是 model， model 就是我們選擇使用 Grok 官網模型類別，這裡我們主要有 8 種模型，詳情可以看我們提供的模型。最後一個參數是messages，messages是我們輸入的提問詞數組，它是一個數組，表示可以同時上傳多個提問詞，每個提問詞包含了 role 和 content，其中 role 表示提問者的角色，我們提供了三種身份，分別為 user 、assistant、system 。另一個 content 就是我們提問的具體內容。 同時您可以注意到右側有對應的調用代碼生成，您可以複製代碼直接運行，也可以直接點擊「Try」按鈕進行測試。 常用可選參數：
  • max_tokens：限制單次回覆的最大 token 數。
  • temperature：生成隨機性，0-2 之間，值越大越發散。
  • n：一次生成多少條候選回覆。

調用之後，我們發現返回結果如下：
返回結果一共有多個字段，介紹如下：
  • id，生成此次對話任務的 ID，用於唯一標識此次對話任務。
  • model ，選擇的 Grok 官網模型。
  • choices，Grok 針對提問詞給予的回答信息。
  • usage ：針對本次問答對 token 的統計信息。
其中 choices 是包含了 Grok 的回答信息，它裡面的 choices 是 Grok回答的具體信息，可以發現如圖所示。

可以看到，choices 裡面的 content 字段包含了 Grok 回覆的具體內容。

​
流式響應

該介面也支持流式響應，這對網頁對接十分有用，可以讓網頁實現逐字顯示效果。 如果想流式返回響應，可以更改請求頭裡面的 stream 參數，修改為 true。 修改如圖所示，不過調用代碼需要有對應的更改才能支持流式響應。

將 stream 修改為 true 之後，API 將逐行返回對應的 JSON 數據，在代碼層面我們需要做相應的修改來獲得逐行的結果。 Python 樣例調用代碼：
輸出效果如下：
可以看到，响应里面有许多 data ，data 里面的 choices 即为最新的回答内容，与上文介绍的内容一致。choices 是新增的回答内容，您可以根据结果来对接到您的系统中。同时流式响应的结束是根据 data 的内容来判断的，如果内容为 [DONE]，则表示流式响应回答已经全部结束。返回的 data 结果一共有多个字段，介绍如下：
  • id，生成此次对话任务的 ID，用于唯一标识此次对话任务。
  • model ，选择的 Grok 官网模型。
  • choices，Grok 针对提问词给于的回答信息。
JavaScript 也是支持的，比如 Node.js 的流式调用代码如下：
Java 样例代码：
其他语言可以另外自行改写，原理都是一样的。

​
多輪對話

如果您想要對接多輪對話功能，需要對 messages 字段上傳多個提問詞，多個提問詞的具體示例如下圖所示：

Python 樣例調用代碼：
透過上傳多個提問詞，就可以輕鬆實現多輪對話，可以得到如下回答：
可以看到，choices 包含的信息與基本使用的內容是一致的，這個包含了 Grok 針對多個對話進行回覆的具體內容，這樣就可以根據多個對話內容來回答對應的問題了。

​
錯誤處理

在調用 API 時，如果遇到錯誤，API 會返回相應的錯誤代碼和信息。例如：
  • 400 token_mismatched：Bad request, possibly due to missing or invalid parameters.
  • 400 api_not_implemented：Bad request, possibly due to missing or invalid parameters.
  • 401 invalid_token：Unauthorized, invalid or missing authorization token.
  • 429 too_many_requests：Too many requests, you have exceeded the rate limit.
  • 500 api_error：Internal server error, something went wrong on the server.

​
錯誤響應示例

​
結論

通過本文檔，您已經了解了如何使用 OpenAI Chat Completion API 輕鬆實現官方 OpenAI ChatGPT 的對話功能。希望本文檔能幫助您更好地對接和使用該 API。如有任何問題，請隨時聯繫我們的技術支持團隊。