Solutions Choose your path
For individuals Build, learn, and create with simple usage-based access. For business Scale teams, billing, governance, and model workflows. More English 繁體中文 日本語 한국어 Français Deutsch Español Italiano Português Русский العربية ไทย Tiếng Việt Bahasa Indonesia Bahasa Melayu Türkçe Polski Nederlands Danish Norsk Қазақ اردو
免費開始 免費開始
500+ AI Model API, All In One API.
Just In CometAPI © 2026 CometAPI · All rights reserved
guide / CometAPI 研究
如何使用 GPT-6.1 Terra API 如何透過 CometAPI 以更具成本效益的方式存取 GPT-6.1 Terra，並涵蓋設定、程式碼範例、推理策略、最佳實務與比較
如何透過 CometAPI 以更具成本效益的方式存取 GPT-6.1 Terra，並涵蓋設定、程式碼範例、推理策略、最佳實務與比較
先用這個摘要快速掌握答案，再閱讀指南取得背景、範例與實作細節。
from openai import OpenAI
client = OpenAI(
api_key="YOUR_COMETAPI_KEY",
base_url="https://api.cometapi.com/v1",
)
response = client.chat.completions.create(
model="gpt-5-mini",
messages=[{"role": "user", "content": "Build this workflow."}],
)
print(response.choices[0].message.content)TLDR
GPT-6.1 Terra（gpt-6.1-terra）是 OpenAI 於 2026 年 10 月 26 日發布的中階 GPT-6.1 模型。它以半價（相較於 GPT-6.1 Sol 與 GPT-5.6 Terra；標準為每百萬詞元 $1（輸入）/$5（輸出））提供強大的視覺推理、精準的電腦操作與自然寫作。具備 1.05M 詞元上下文視窗、可配置的推理強度（none 到 max）、影像輸入，以及透過 Responses API 的完整工具支援，非常適合大量代理式工作流程，如發票處理、技術圖紙解讀、螢幕互動與文件修訂。本文涵蓋精確的設定步驟、程式碼範例、推理策略、最佳實務、比較，以及如何透過 CometAPI 更具成本效益地存取。
Key Takeaways
Model ID: gpt-6.1-terra — 1,050,000 上下文視窗、128,000 最大輸出詞元、知識截止 2026 年 6 月 1 日。
定價（OpenAI 標準）：每 100 萬輸入/輸出詞元 $1 / $5；快取輸入 $0.05；長上下文（>272K 輸入）與 Fast 模式費率更高。
最適合視覺 + 電腦操作任務；相較 GPT-5.6 Terra 有明顯提升，並在更低成本與更高速度下匹敵或接近更高階模型。
偏好使用 Responses API 進行工具呼叫、電腦操作、結構化輸出與推理控制。
CometAPI 以折扣價（約 $0.80 / $4.00）提供同款模型，單一 OpenAI 相容金鑰覆蓋 500+ 模型，便於切換並持續節省 20–40%。
What Is GPT-6.1 Terra?
GPT-6.1 Terra 是 GPT-6.1 家族中快速、高效的中階模型，定位介於輕量級的 Luna 與更強大的 Sol/Astra 之間。官方強調其在細緻視覺推理、精準電腦操作（螢幕互動、表單填寫、應用程式控制）與更清晰自然的寫作方面表現突出。
它支援文字與影像輸入，並產生文字輸出。原生不支援音訊或視訊的輸入/輸出。關鍵能力包括串流、結構化輸出、函式呼叫、提示快取、網頁搜尋、檔案搜尋、電腦操作、程式碼解譯器等——主要透過 Responses API 提供。
OpenAI 指出，相較 GPT-5.6 Terra，其在 Agents’ Last Exam（專業電腦操作任務）上得分更高，成本約為其三分之一；在一些視覺與代理基準上接近 GPT-6 Astra，且每詞元價格約為其十分之一；虛構率顯著降低；且在相關工作負載上任務完成速度比 Sol 或 Astra 快超過 3 倍。
GPT-6.1 Terra Specifications and Pricing
輸入：$1.00
快取輸入：$0.05
快取寫入（保留 30 分鐘）：$1.25
輸出：$5.00
註記：提示超過 272K 輸入詞元時，整個請求將套用 2× 輸入/快取與 1.5× 輸出費率。Batch/Flex 低 50%；Fast 模式為 2×。區域性處理可能會加價。
How to Set Up GPT-6.1 Terra API
Direct OpenAI
建立或使用具 API 存取權限的 OpenAI 專案（Build 方案以上；Free 方案不支援此模型）。
產生 API 金鑰並妥善保存（環境變數或機密管理工具）。
安裝最新版 OpenAI SDK：pip install --upgrade openai（Python）或 npm install openai（Node.js）。
Account and credentials 在 CometAPI 登入、產生 API 金鑰，並確認可用的 gpt-6.1-terra。將憑證儲存在環境變數中，不要放在應用程式原始碼裡。
CometAPI 金鑰用於驗證至 CometAPI 的請求。請只在開發環境或後端保存，不要嵌入公開網頁或提交至原始碼庫。確保執行腳本的終端可取得該環境變數。
在 Bash 中設定金鑰。
export COMETAPI_KEY="your_cometapi_api_key"
在 Windows 上，於 PowerShell 設定相同變數。
$env:COMETAPI_KEY="your_cometapi_api_key"
A small, specific first request 先用一個簡短的文字提示與一次回應，再加入影像資料、JSON 結構或函式。確認模型可存取與基底 URL https://api.cometapi.com/v1。若帳戶提供多條路徑，請選符合你計畫使用功能的文件路徑。
How Do You use a GPT-6.1 Terra API Response?
Send the first text request 在客戶端設定後新增以下程式碼，並將合併後的腳本儲存為 first_request.py。此程式會請求一段短答、檢查完成狀態，並將文字寫入 UTF-8 檔案。
產生文字回應、驗證完成狀態，並儲存為 answer.txt。
response = client.responses.create(
model="gpt-6.1-terra" ,
instructions="You are a concise technical writing assistant." ,
input ="Summarize three common causes of failed API integrations and their fixes." ,
reasoning={"effort" : "medium" },
max_output_tokens=2000 ,
)
if response.status != "completed" :
raise RuntimeError(
f"Response status: {response.status} ; "
f"details: {response.incomplete_details} "
)
if not response.output_text.strip():
raise RuntimeError("No text returned; inspect response.output" )
Path("answer.txt" ).write_text(response.output_text, encoding="utf-8" )
print (response.output_text)
print ("Saved answer.txt" )
print (response.usage)
Run the combined client-and -request script.
python first_request.py
Check the saved answer 開啟 answer.txt，確認答案有回應提示，且包含三個請求的成因與修正。API 回應標示完成只代表生成已結束；你的應用仍需檢查內容是否符合需求。若需比較成本，請保留回傳的使用量紀錄。
Use cURL for a direct HTTP check 若要不透過 SDK 直接快速檢查端點，於已設定 COMETAPI_KEY 的 Bash 執行以下指令。檢視回傳的 JSON，包括 status、output 與 usage。請勿假設第一個輸出項目一定包含最終文字。
curl -sS https:
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model" : "gpt-6.1-terra" ,
"input" : "Explain how AI can reduce invoice-processing errors in 100 words." ,
"reasoning" : { "effort" : "medium" } ,
"max_output_tokens" : 600
} '
Choose request settings 推理詞元會計入輸出預算。若回應不完整，請在解析或顯示前檢查其 status 與 incomplete_details。參見推理詞元指南 ，了解為何較小的 max_output_tokens 可能在可見答案完成前就被推理消耗。
Controlling Reasoning Effort
none：最快，適合簡單抽取/分類。
low：日常任務。
medium（預設）：多數混合或多步驟工作。
high / xhigh / max：複雜視覺差異、規劃或高風險任務——僅在評估證實值得時使用，以避免額外詞元/延遲。
Chat Completions 可處理純文字/影像（不含工具），但工具呼叫與部分進階功能需要 Responses。
How Can GPT-6.1 Terra API Analyze Images? 此模型可同時接收影像與文字，支援螢幕截圖解讀、文件擷取、技術圖檢閱與視覺材料比較。OpenAI 的視覺輸入文件 說明了 input_image 內容區塊。
Analyze a local invoice image with Python 將本地 PNG 編碼後連同發票擷取提示一併送出。Terra 尤其擅長產品照片匹配、技術圖紙、螢幕截圖與視覺品保。
response = client.responses.create(
model="gpt-6.1-terra" ,
reasoning={"effort" : "medium" },
input =[{
"role" : "user" ,
"content" : [
{"type" : "input_text" , "text" : "Review this campaign image. List only visible issues with cropping, text placement, contrast, and logo safety. Cite regions and propose fixes." },
{"type" : "input_image" , "image_url" : "https://example.com/image.jpg" , "detail" : "high" }
]
}]
)
print (response.output_text)
支援的格式包括 PNG、JPEG、WEBP、非動畫 GIF。請視需求使用 detail: "high" 或 "low"；較高細節會消耗更多詞元。亦支援 base64 資料 URL。
工具呼叫（函式呼叫、電腦操作、網頁搜尋、檔案搜尋、程式碼解譯器、MCP 等）需要使用 Responses API。
在隔離環境（瀏覽器/虛擬機）執行。
嚴格使用允許清單（網站/動作）。
對高影響動作（購買、刪除、資料匯出）要求人工審核。
設定步數/時間/成本上限。
驗證最終狀態，不要只信任模型摘要。
將頁面內容視為不受信任（官方宣稱具強韌的提示注入防護，但仍需縱深防禦）。
Should You Use Responses or Chat Completions? 對 GPT-6.1 Terra 而言，Chat Completions 可支援不含工具的純文字與影像請求。工具呼叫則需要 Responses；對多步驟代理流程、對話狀態管理、跨工具呼叫保留推理脈絡與進階串流事件，亦建議使用 Responses。請確保使用的相容閘道支援所送出的端點與欄位。請參考官方遷移指南 。
遷移既有整合時，變更流量前請檢查三件事：模型 ID、端點與請求參數。啟用工具的 Chat Completions 請求需要改為 Responses 的實作；僅更換模型名稱並不足夠。在 Responses 中使用 reasoning.effort；在 Chat Completions 中使用 reasoning_effort。
Handle Errors in a GPT-6.1 Terra API Workflow 先區分需修正的請求與暫時性的連線或服務故障。診斷選配參數時，從最小可行請求開始，並將錯誤細節留在伺服端記錄（勿包含 API 金鑰）。
驗證或存取失敗：重檢金鑰、目的主機、帳戶權限與可用餘額，再行重試。
不支援的參數：移除選配欄位，確認端點與模型，並逐一加入欄位。
生成不完整：檢查 status 與 incomplete_details；在取用結果前調整輸出預算或簡化任務。
速率限制或暫時性失敗：使用有界退避與重試上限。重試可能產生新的計費回應。
串流中斷：保留部分文字作為中斷輸出。不要將其視為完整答案，亦勿依據部分工具請求執行動作。
工具或下游失敗：在重複一項業務
Conclusion GPT-6.1 Terra 為打造高量視覺與電腦操作代理的開發者帶來務實的飛躍。其改進的能力、顯著更佳的成本效率與可配置推理，讓其成為許多以往需要更昂貴模型之生產工作負載的預設選擇。
從 Responses API 起步，先以 medium 推理強度，強制結構化輸出與安全護欄，並透過 CometAPI 這類統一平台路由流量以獲得最佳成本與彈性。依照本文的設定與模式，你可在數分鐘內從零達到可量產的整合，同時控管長期成本。
關於最新定價、速率限制與功能可用性，請隨時交叉查驗官方 OpenAI 文件與你的 CometAPI 儀表板。祝開發順利！
FAQs
Can multiple users share a GPT-6.1 Terra API conversation? 請依使用者或授權工作區隔離對話歷史。共享後端可持有 API 憑證，但不代表所有使用者都可讀取所有對話。在載入先前訊息或儲存結果前，請確認當前使用者具備該對話的存取權。對協作工作流程，需定義誰可檢視與延伸共享歷史。
Will the same GPT-6.1 Terra API prompt return identical text? 請勿依賴重複生成產生完全相同的位元級輸出。當需重現時，保存提示、模型 ID、設定與已接受的結果。若之後需要完全相同的文字，請取回先前保存的答案，而非重新生成。評估新回應時請以任務需求為準，不要僅因措辭不同而判定失敗。
Does store=False define the privacy policy for the entire API workflow? 不。請求層級的儲存設定無法涵蓋你的應用與 API 閘道中所有日誌、快取或保留政策。請先審閱各服務的條款與資料控管，再傳送機密文件。限制送出的資料，且避免為了除錯方便而在應用日誌中記錄敏感提示內容。
How do I get a GPT-6.1 Terra API key? 你可以透過 CometAPI 存取 GPT-6.1 Terra API 。建立帳戶、產生 API 金鑰，並將 SDK 設定為基底 URL https://api.cometapi.com/v1 與模型 ID gpt-6.1-terra。不需要額外的 OpenAI API 金鑰。
How much does the GPT-6.1 Terra API cost? 截至 2026 年 10 月 28 日，OpenAI 官方定價 為每百萬輸入詞元 $1.00、每百萬快取輸入詞元 $0.05、每百萬輸出詞元 $5.00。CometAPI 公布的費率為輸入 $0.80、輸出 $4.00，約便宜 20%。以 10,000 未快取輸入詞元與 2,000 輸出詞元估算，透過 CometAPI 約 $0.016，相較 OpenAI 約 $0.020，未含其他費用。
Is GPT-6.1 Terra API free to use? 否。根據 OpenAI 的模型文件 ，GPT-6.1 Terra 不對 Free API 方案開放，付費的 Build 方案以上可用。ChatGPT Plus、Pro、Enterprise 與 Edu 使用者可透過 ChatGPT Work 與 Codex 使用 Terra，但 API 使用將與 ChatGPT 訂閱分開計費。或者，開發者也可透過 CometAPI 使用有效金鑰與足夠儲值來存取 GPT-6.1 Terra，供應情況以服務提供者為準。
Model ID gpt-6.1-terra Context Window 1,050,000 詞元 Max Input Tokens ~922,000 Max Output Tokens 128,000 Knowledge Cutoff 2026 年 6 月 1 日 Input Modalities 文字、圖像 Output Modalities 文字 Reasoning Effort Levels none、low、medium（預設）、high、xhigh、max Supported Endpoints Chat Completions、Responses、Batch Tool Calling 需要 Responses API Fine-tuning 不支援
model 選擇 gpt-6.1-terra。 input 傳入提示、訊息、影像或對話項目。 instructions 設定行為與輸出要求。 reasoning.effort 選擇 none、low、medium（預設）、high、xhigh 或 max。 max_output_tokens 限制推理與可見輸出的合計預算。 stream 以事件逐步接收回應。 text.format 請求結構化輸出格式。 tools 宣告可呼叫的函式。
Positioning 中階，高量視覺/電腦操作 能力更高 上一代中階 前沿 Standard Price (in/out) $1 / $5 ~$2 / $10 ~$2 / $12 高出許多 Context 1.05M 類似 類似 類似 Speed on agent tasks 本組中最快 較慢 較慢 較慢 Agents’ Last Exam 強（較 5.6 在 medium 高 15 分） 在困難程式碼上更強 基線 可比或略優 Best Use 高量代理、視覺品保、表單 複雜程式/推理 遺留 最高能力
如何使用 GPT-6.1 Terra API - CometAPI
