如何以 Python 使用 Grok 4.7 API：API 金鑰、OpenAI SDK 與第一個請求

最後驗證：2026 年 9 月 28 日。

xAI 推出 Grok 4.7（2026 年 9 月），用於程式開發、代理型任務與知識型工作。其支援 500,000-token 的上下文視窗、Responses API 與 Chat Completions。對開發者而言，難點常常不在第一個請求，而是在多模型堆疊中，同步管理另一個供應商憑證、SDK 設定、計費帳戶、模型目錄與端點。

你可以透過將 OpenAI SDK 的用戶端指向 CometAPI、使用 CometAPI 金鑰驗證，並選擇 grok-4.7，在 Python 中呼叫 Grok 4.7。相同的 CometAPI 帳戶、金鑰與基底 URL 也可存取支援的 GPT、Claude、Gemini 與 DeepSeek 模型。換言之，你可以保留單一閘道整合，並為每個任務選擇最合適的模型。

本指南先以 Grok 4.7 完成第一個可運行的請求，接著說明在加入其他模型家族時有哪些部分保持不變。同時也解釋「單一 API」的重要限制：驗證與閘道存取是統一的，但模型專屬的工具、參數、上下文限制與支援的端點仍可能不同。

Grok 4.7 Python 快速入門

目前的 CometAPI Grok 4.7 模型頁面記載了模型 ID grok-4.7、基底 URL https://api.cometapi.com/v1，以及使用 OpenAI SDK 的 Python 範例。該專屬頁面採用 Responses API，因此作為本教學的起點最為安全。

1. 建立 CometAPI 金鑰

建立或登入你的 CometAPI 帳戶，然後在 API token 主控台產生金鑰。請將其儲存為環境變數，而不是直接寫入原始碼。

export COMETAPI_KEY="your_cometapi_key_here"

Windows PowerShell：

$env:COMETAPI_KEY="your_cometapi_key_here"

不要將金鑰提交至 Git、貼到公開筆記本，或暴露在瀏覽器端 JavaScript。正式環境的應用程式應從機密管理工具或受保護的伺服器環境載入金鑰。

2. 安裝 OpenAI Python SDK

建立隔離環境並安裝目前的 SDK：

python -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade openai

在 Windows 上，使用 .venv\Scripts\Activate.ps1 啟用環境。官方的 OpenAI API 快速入門使用相同的 Python 套件與用戶端模式；CometAPI 僅更動 API 金鑰、基底 URL 與模型 ID。

3. 傳送第一個 Grok 4.7 請求

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["COMETAPI_KEY"],
    base_url="https://api.cometapi.com/v1",
)

response = client.responses.create(
    model="grok-4.7",
    input="Explain one practical use of a unified AI API in two sentences.",
)

print(response.output_text)

將檔案儲存為 grok47_quickstart.py，然後執行：

python grok47_quickstart.py

若請求成功，腳本會輸出模型的文字回應。你的應用程式此時即使用 OpenAI Python 用戶端，並將流量送至 CometAPI，同時透過模型 ID 選擇 Grok 4.7。

Grok 4.7 請求中每一行的作用

api_key。 SDK 會將你的 CometAPI 憑證附帶在請求中。同一把 CometAPI 金鑰可用於該帳戶下啟用的所有模型。

base_url。 將 OpenAI 用戶端從預設的 OpenAI 服務導向 CometAPI 閘道。請保留 /v1 後綴。

model="grok-4.7"。 模型 ID 指定 Grok 4.7。請將模型 ID 視為精確、區分大小寫的部署輸入，並在發佈前於即時模型頁面確認。

client.responses.create(...)。 透過 Responses API 發送請求。CometAPI 目前的 Grok 4.7 頁面記載此路由，xAI 目前的 Grok 4.7 文件亦列為支援 Responses API。

能否改用 Chat Completions 搭配 Grok 4.7？

可以。CometAPI 於 2026 年 9 月 22 日的更新日誌指出 Grok 4.7 支援 Chat API 格式。若既有應用程式建立於 Chat Completions，對應的 OpenAI SDK 呼叫如下：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["COMETAPI_KEY"],
    base_url="https://api.cometapi.com/v1",
)

completion = client.chat.completions.create(
    model="grok-4.7",
    messages=[
        {
            "role": "user",
            "content": "Give me a three-step API migration checklist.",
        }
    ],
)

print(completion.choices[0].message.content)

當模型頁面與新版 OpenAI SDK 工作流程一致時，請使用 Responses；若你在維護既有的聊天整合，則使用 Chat Completions。不要假設每個原生工具或模型專屬參數在兩種格式中都有完全一致的表徵。

如何透過單一 CometAPI 整合連接 GPT、Claude、Gemini、DeepSeek 與 Grok

當應用程式需要多個模型家族，且不想為每個供應商各自維護憑證與用戶端初始化流程時，統一模型閘道便很有用。在 CometAPI 中，API 金鑰與基底 URL 保持固定，而應用程式僅需從目前目錄選擇模型 ID。端點格式與供應商特定功能仍可能不同，因此每個模型都應以實際上線時的請求形狀進行測試。

CometAPI 目前的模型選項（2026 年 9 月 28 日已驗證）

CometAPI 目前在其目錄中列出以下模型家族。以下範例使用 2026 年 9 月 28 日驗證的模型 ID；可用性、別名、能力與定價會變動，因此正式部署前應重新檢查即時模型頁面。

模型家族	目前範例模型 ID	模型概述與需驗證事項
Grok	grok-4.7	Grok 4.7 針對程式開發、代理型任務與長篇知識工作。請驗證 Responses 與 Chat 格式、推理控制、工具與現行費率。
GPT	gpt-6-sol	GPT-6 Sol 最適合複雜的程式開發與代理工作流程。請驗證端點支援、推理等級、上下文需求與可用工具。
Claude	claude-opus-5-5	Claude Opus 5.5 為高能力推理與代理模型。請驗證 Messages 與 Chat 格式，以及 Anthropic 特定工具行為。
Gemini	gemini-3.8-flash	Gemini 3.8 Flash 著重於速度與多模態工作負載。請驗證 Gemini 原生格式與 Chat 格式、媒體輸入與對齊/接地選項。
DeepSeek	deepseek-v4-pro	DeepSeek V4 Pro 聚焦進階推理、程式開發與長程代理。請驗證 Chat 相容性、推理行為與目前輸出限制。

這些模型 ID 已於 2026 年 9 月 28 日與 CometAPI 的目錄與模型頁面核對。可用性、別名與價格可能變動；正式程式碼應使用核准的允許清單，並在部署前重新檢查即時目錄。

對於簡單且與 OpenAI 相容的文字工作流程，你可以將模型做成可設定項：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["COMETAPI_KEY"],
    base_url="https://api.cometapi.com/v1",
)

model = os.getenv("COMETAPI_MODEL", "grok-4.7")

response = client.responses.create(
    model=model,
    input="Summarize the advantages and limits of a unified AI API.",
)

print(response.output_text)

可重用的部分包括帳戶、API 金鑰、閘道 URL、SDK 初始化，以及你應用程式的請求包裝。可能會變動的是特定模型家族所需的端點或請求結構。單一 API 可降低整合與計費的分裂，但不會消除上游模型的能力與限制。

更安全的多模型 Python 模式

正式應用程式應定義允許清單，而非接受使用者任意輸入的模型名稱。請將能力資訊與每個核准模型綁在一起，讓應用程式可選擇相容的端點與功能組合。

MODEL_CONFIG = {
    "grok": {
        "id": "grok-4.7",
        "api": "responses",
    },
    "gpt": {
        "id": "gpt-6-sol",
        "api": "responses",
    },
}

def run_text_request(client, family, prompt):
    config = MODEL_CONFIG[family]

    if config["api"] == "responses":
        result = client.responses.create(
            model=config["id"],
            input=prompt,
        )
        return result.output_text

    raise ValueError(f"Unsupported API format: {config['api']}")

僅在使用你應用程式所用端點與參數，完成測試後再擴充允許清單。此做法可避免目錄變更或拼寫錯誤，悄悄將正式流量導向非預期模型。

常見錯誤與修正方式

驗證失敗。 確認執行 Python 的同一個 Shell 中存在 COMETAPI_KEY，金鑰仍有效，且未夾帶多餘空格或引號。

找不到模型。 重新檢查即時的精確模型 ID。對本指南而言，已驗證的 ID 為 grok-4.7；不要用「Grok 4.7 API」之類的顯示名稱替代。

端點拒絕參數。 移除供應商特定的選項，並以最小化且文件記載的請求重試。OpenAI 相容性涵蓋常見 SDK 形狀，但不包含 GPT、Claude、Gemini、DeepSeek 與 Grok 的所有原生參數。

觸發速率限制或餘額不足。 在增加重試次數前，先檢查帳戶使用量與配額。盲目重試可能增加成本與負載，但無法解決帳戶層級限制。

請求逾時或回傳暫時性伺服器錯誤。 加入有界指數退避、請求逾時與最大重試次數。記錄請求 ID 與所選模型，但切勿記錄 API 金鑰或敏感提示內容。

正式上線檢查清單

將 CometAPI 金鑰存放於機密管理工具，若外洩請立即輪替。
在設定中釘選核准的模型 ID，並於部署前檢視即時目錄。
以你實際要用的端點、串流模式、工具呼叫、結構化輸出與多模態輸入進行測試。
設定明確的逾時與有界重試；不要重試無效請求。
記錄模型、延遲、Token 使用量、請求 ID 與成本中繼資料，但不要儲存機密。
在切換正式流量至新模型或別名前，先執行小規模金絲雀。

為何在此流程中使用 CometAPI？

當團隊想要測試或運營多個模型家族，又不想為每個供應商分別建立整合、憑證流程與預付餘額時，CometAPI 很有幫助。Grok 4.7 快速入門沿用熟悉的 OpenAI Python 用戶端，同一個 CometAPI 帳戶同時可涵蓋支援的 GPT、Claude、Gemini、DeepSeek、Grok 與多模態模型。

其優勢在於營運整併：一個帳戶、一把金鑰、一個閘道 URL 與共享的使用面。工程紀律仍需模型感知：團隊仍應在上線前驗證端點相容性、模型特定能力、定價、資料需求與回退行為。

CometAPI 上的 Grok 4.7 價格

CometAPI 的 Grok 4.7 模型頁面列出兩個上下文等級。以下價格為每 100 萬 Token 的美元價格，並於 2026 年 9 月 28 日驗證。

層級	條件	輸入	快取輸入 / 快取讀取	輸出
標準上下文	len < 200,000	$1.60	$0.40	$4.80
長上下文等級	請見即時計費頁面上的目前規則	$3.20	$0.80	$9.60

同一頁面列出的對應 xAI 直連費率為標準上下文每百萬 Token：輸入 $2.00、快取讀取 $0.50、輸出 $6.00；長上下文則為輸入 $4.00、快取讀取 $1.00、輸出 $12.00。相較之下，當時 CometAPI 顯示的費率低 20%。請將這些數字視為有時效性的快照，並在估算正式支出前檢查即時定價頁面。

常見問題（FAQ）

CometAPI 上 Grok 4.7 的 API 模型 ID 是什麼？

目前的模型 ID 為 grok-4.7。

可以用 OpenAI Python SDK 搭配 Grok 4.7 嗎？

可以。以你的 CometAPI 金鑰初始化 OpenAI，將 API 基底 URL 設為 api.cometapi.com/v1，然後在支援的端點中使用 model="grok-4.7"。

還需要 xAI 的 API 金鑰嗎？

若採本指南示範的 CometAPI 路徑則不需要。請求以 CometAPI 金鑰驗證，並由 CometAPI 帳戶計費。

同一把 CometAPI 金鑰能存取 GPT、Claude、Gemini 與 DeepSeek 嗎？

可以，只要該模型可供你的 CometAPI 帳戶使用。保留 CometAPI 金鑰與基底 URL，選擇受支援的模型 ID，並使用該模型文件記載的端點。

「單一 API」是否表示每個模型都接受相同參數？

不是。單一 API 可統一帳戶存取、驗證、路由與計費；但原生工具、推理控制、多模態輸入、安全性設定、上下文限制與端點支援仍會因模型而異。

Grok 4.7 應該用 Responses 還是 Chat Completions？

建議從 Responses 開始，因為目前的 CometAPI Grok 4.7 模型頁面提供該範例。CometAPI 更新日誌也記載支援 Chat Completions；若你維護的是既有的聊天式程式碼庫，亦可選用。

重點結論

要在 Python 呼叫 Grok 4.7：安裝 OpenAI SDK、建立 CometAPI 金鑰、設定本指南中的 CometAPI 基底 URL，並選擇 grok-4.7。從最小化請求開始，確認端點與回應結構，然後在進入正式環境前加入重試、逾時、記錄與成本控管。

將共享整合作為穩定基礎，同時對你新增的每個模型保留明確的能力檢查。這種平衡——以單一營運閘道配合模型感知的驗證——是將多模型 API 轉化為正式軟體的最安全方式。