|

GPT-6.1 Terra API 調用教程：5 步從獲取 Key 到第一個請求

ByShark
GPT-6.1 Terra API 調用教程：5 步從獲取 Key 到第一個請求

作者注：以控制檯操作爲主線，5 步完成 GPT-6.1 Terra API 接入，講清端點選擇、參數坑和 272K 階梯計價。

先說結論：接入 GPT-6.1 Terra 只有一個關鍵選擇，就是用 Responses 還是 Chat Completions。 需要工具調用就必須用 Responses；不需要工具的話，現有代碼基本照抄，改一下模型名就能跑。

GPT-6.1 Terra 於 2026-10-26 發佈，模型 ID 是 gpt-6.1-terra，官方文檔已經寫明端點、參數和計價規則，這些信息有據可查。本文按控制檯頁面的操作順序展開：註冊 → 建令牌 → 找 Base URL → 填模型名 → 跑第一次請求。每一步都附有驗收標準，命令行和代碼只作爲可選寫法。

核心價值：讀完本文，你能在控制檯裏完成 GPT-6.1 Terra API 的接入鏈路驗證，並避開最常見的 400 報錯。

📌 平臺現狀說明：截至 2026-10-27，API易 apiyi.com 的實時型號列表中還沒有 gpt-6.1-terra，我們會盡快推出此模型。同代的 gpt-6-astra、gpt-6-sol、gpt-6.1-sol、gpt-6-luna 已經上架，可以先用 gpt-6.1-sol 驗證接入鏈路。型號與價格以平臺型號列表爲準。

gpt-6-1-terra-api-first-request-guide-zh-hant-image-0

GPT-6.1 Terra API 核心要點

要點 說明 對你的意義
模型 ID gpt-6.1-terra，2026-10-26 發佈 請求裏的 model 字段照此填寫
可用端點 Responses、Chat Completions、Batch Realtime、Assistants、Embeddings 等端點都不支持
工具調用 只有 Responses 支持 Chat 端帶上 tools 會直接失敗
上下文 總 1,050,000，單次輸入 922,000，輸出 128,000 適合長文檔，但要注意 272K 計價階梯
模態 輸入爲文本和圖片，輸出爲文本 圖片走 Responses 的 input_image
知識截止 2026-06-01 更新的信息需要配合 web_search 工具獲取

GPT-6.1 Terra 能力邊界詳解

GPT-6.1 Terra 支持 streaming、structured outputs、function calling、file_search、image input、web search 和 prompt caching，不支持 fine-tuning 和 predicted outputs。如果你的舊項目依賴微調模型或預測輸出，就不能直接遷移過來。

Responses 端點可以掛載的工具很多，包括 web_search、file_search、image_generation、code_interpreter、hosted_shell、apply_patch、skills、computer_use、mcp 和 tool_search。這也是”要工具就選 Responses”的根本原因：Chat Completions 在這個模型上只負責純對話。

如何調用 GPT-6.1 Terra API：5 步控制檯流程

gpt-6-1-terra-api-first-request-guide-zh-hant-image-1

第 1 步：註冊賬號

  1. 打開 API易 apiyi.com，按頁面提示用本人信息註冊賬號，平臺要求本人註冊。
  2. 新賬號自帶 0.05 美元試用額度，不充值也能跑通一次輕量調用。
  3. 驗收標準：登錄後進入控制檯，錢包或餘額頁能看到試用額度。
  4. 卡住時看：如果看不到額度，先確認是否完成了註冊流程，不要急着充值。

如果走官方渠道，需要在 OpenAI 平臺的 API Keys 頁面創建 Key。前提是賬號位於支持地區，並且已經充值到 Build 層，也就是至少 5 美元。

第 2 步：新建令牌並選對分組

  1. 進入控制檯的令牌頁面 api.apiyi.com/token，點擊新建令牌。
  2. 在「選擇分組」裏挑一個分組。分組決定了可用模型、計費倍率和上游線路。default 和 svip 與官方同價，CodexReverse 走逆向資源。
  3. 驗收標準：保存後，令牌列表裏出現一條以 sk- 開頭的 Key。
  4. 卡住時看：用戶層的「分組」不等於令牌分組，真正生效的是令牌上選的那一個。

第 3 步：找到 Base URL

Base URL 要按 SDK 區分，這是最容易填錯的地方：

  • OpenAI SDK：https://api.apiyi.com/v1，要帶 /v1
  • Anthropic SDK：用根域名，不帶 /v1
  • Google GenAI SDK：用根域名，同時把 api_version 設爲 v1beta

驗收標準：GPT-6.1 系列使用 OpenAI SDK 或 OpenAI 兼容客戶端，填好的地址以 /v1 結尾。卡住時看：如果報 404，十有八九是 /v1 漏寫或重複寫了。

第 4 步：填寫模型名

在客戶端或調試工具的模型字段裏填寫模型 ID。建議先用 gpt-5.4-mini 這類輕量模型跑通鏈路，再換成 gpt-6.1-sol。等 gpt-6.1-terra 在平臺上架後，只需要改一個字段。平臺沒有 auto、auto:free 這類免費路由寫法，不要嘗試。

驗收標準：模型名與平臺型號列表裏的寫法逐字一致。卡住時看：報模型不存在時，先去型號列表覈對拼寫，再檢查令牌分組是否覆蓋了這個模型。

第 5 步：跑通第一次請求

下面是最小可用示例，可選寫法，共 5 行：

  1. 設置環境變量：export OPENAI_API_KEY=sk-你的令牌
  2. 創建客戶端：client = OpenAI(base_url="https://api.apiyi.com/v1")，Key 會自動從環境變量讀取
  3. Responses 寫法：r = client.responses.create(model="gpt-6.1-sol", input="用一句話介紹你自己", reasoning={"effort": "low"}, max_output_tokens=800)
  4. Chat 寫法：c = client.chat.completions.create(model="gpt-6.1-sol", messages=[{"role": "developer", "content": "簡潔回答"}, {"role": "user", "content": "你好"}], max_completion_tokens=800)
  5. 打印核對：print(c.model, c.usage.prompt_tokens)

驗收標準：請求返回 HTTP 200，usage.prompt_tokens 有數字（Responses 端看 usage.input_tokens）。換成 gpt-6.1-terra 後，響應裏的 model 字段能回顯這個模型名。

🚀 快速開始：建議先在 API易 apiyi.com 用試用額度跑通 gpt-6.1-sol，確認 Key、分組和 Base URL 都沒問題。Terra 上架後改一下模型名即可切換，型號與價格以平臺型號列表爲準。

步驟 控制檯操作 驗收標準 卡住時先查
1 註冊 本人註冊並登錄 能看到 0.05 美元試用額度 註冊流程是否完成
2 令牌 新建令牌並選擇分組 列表出現 sk- 開頭的 Key 令牌分組與用戶分組是否混淆
3 Base URL OpenAI SDK 填 /v1 地址 地址以 /v1 結尾 404 時檢查 /v1
4 模型名 填寫 gpt-6.1-sol 等型號 與型號列表逐字一致 拼寫和分組覆蓋範圍
5 請求 發出第一次調用 返回 200，usage 有數字 狀態碼、響應體、x-request-id

當然，你也可以直接用 Magpie 更方便的接入。它把 Key 和 Base URL 填在圖形界面裏，自動幫你把 Claude Code、Codex、Pi、Hermes 這類編程 Agent 接上同一個網關，不用逐個改配置文件。

GPT-6.1 Terra API 端點選擇：Responses 對比 Chat Completions

gpt-6-1-terra-api-first-request-guide-zh-hant-image-2

對比項 Responses（v1/responses） Chat Completions（v1/chat/completions）
工具調用 支持，可掛載 10 類內置工具 不支持，帶 tools 會失敗
系統指令 instructions messages 中的 developer 角色，比 system 更穩
推理力度 reasoning: {effort: ...} reasoning_effort
輸出上限 max_output_tokens max_completion_tokens
輸入格式 字符串或消息數組，圖片用 input_image messages 數組
多輪迴放 include: ["reasoning.encrypted_content"]，並把上輪 output 原樣帶回 自行拼接歷史消息
流式 usage 默認返回 需加 stream_options: {include_usage: true}

Chat Completions 對標分析：Chat 端在兼容老代碼方面優勢明顯，大多數項目只改模型名就能運行。但它在 Terra 上不能調用工具，部分分組還會丟棄 system 消息。相比之下，Responses 原生支持工具和加密推理回放，更適合構建 Agent 和多輪推理場景。

推理力度共有 none、low、medium（默認）、high、xhigh、max 六檔，沒有 minimal。推理 token 會計入輸出計費和輸出上限，所以 max_output_tokens 要預留餘量，否則可能推理還沒結束輸出就被截斷了。

GPT-6.1 Terra API 三個參數坑

gpt-6-1-terra-api-first-request-guide-zh-hant-image-3

坑 錯誤寫法 正確寫法 後果
Chat 帶 tools 在 chat.completions 裏傳 tools 改用 Responses 端點 請求失敗
用了舊參數 Chat 端傳 max_tokens 改爲 max_completion_tokens 400
採樣參數衝突 effort 不是 none 時傳 temperature 或 top_p 刪除 temperature、top_p、top_logprobs，Chat 端還要刪 logprobs 400

除了這三個坑，官方還列出了幾個會觸發 400 的情況：effort 傳了 minimal、prompt_cache_options.ttl 傳了非法值、輸入超過 922,000 tokens。圖片輸入的鏈接必須能被服務端下載，帶反爬的站點會導致失敗，這時改用 base64 data URL 更穩。

排查報錯時有一個關鍵習慣：錯誤原文只在響應體裏出現一次，後臺日誌是計費賬本，失敗的調用不會入賬。所以要保留 HTTP 狀態碼、原始響應體全文和響應頭裏的 x-request-id。不要先調用 raise_for_status() 再去讀 body，那樣錯誤信息就丟了。

GPT-6.1 Terra API 價格與 272K 階梯

以下爲官方定價，單位是美元每百萬 tokens。注意階梯是按整條請求劃分的：只要輸入超過 272K，這一整單的所有計費項都按第二檔計算。

計費項 輸入 ≤ 272K 輸入 > 272K
輸入 1 2
輸出（含推理 token） 5 7.5
緩存讀取 0.05 0.1
緩存寫入（30 分鐘） 1.25 2.5
緩存寫入（12 小時） 2.50 5

估算成本時要把四項都算進去：輸入、輸出、緩存讀取、緩存寫入。緩存寫入還要區分 30 分鐘和 12 小時兩種時長。只看輸入和輸出單價，會低估長上下文加緩存場景的費用。平臺上已上架的同代模型，四項計費都與官網逐項一致，並且同樣按兩檔整單計費。

官方 Standard 檔的限流如下：Build 爲 5,000 RPM / 100 萬 TPM，Launch 爲 1 萬 RPM / 400 萬 TPM，Grow 爲 1.5 萬 RPM / 4000 萬 TPM。

💰 成本建議：長文檔任務儘量把單次輸入控制在 272K 以內，再配合 prompt caching，能明顯降低單價。通過 API易 apiyi.com 選擇 default 或 svip 分組可以享受與官方同價的計費，具體型號與價格以平臺型號列表爲準。

GPT-6.1 Terra API 安全提醒

Key 要放在環境變量或密鑰管理服務裏，不要硬編碼到源碼中，更不要提交到 git 倉庫。建議在 .gitignore 裏排除 .env 文件。一旦 Key 泄露，立即到令牌頁刪除並重建。另外，令牌要選對分組：分組錯了，輕則報模型不可用，重則按意料之外的倍率計費。不同項目最好使用不同的令牌，便於分別控制額度和停用。

常見問題 FAQ

Q1：什麼是 GPT-6.1 Terra？

它是 OpenAI 在 2026-10-26 發佈的模型，ID 爲 `gpt-6.1-terra`。上下文長度爲 1,050,000，輸入支持文本和圖片，輸出爲文本，可以通過 Responses、Chat Completions 和 Batch 三個端點調用。

Q2：GPT-6.1 Terra 的 Responses 和 Chat Completions 怎麼選？

需要工具調用（如 function calling、web_search）就選 Responses；純對話場景用 Chat 也可以，但要改用 max_completion_tokens，並且不能帶 tools。

Q3：API易現在能調用 gpt-6.1-terra 嗎？

截至 2026-10-27 還沒有上架，我們會盡快推出此模型。可以先在 API易 apiyi.com 用同代的 `gpt-6.1-sol` 驗證接入鏈路，型號與價格以平臺型號列表爲準。

Q4：爲什麼傳了 temperature 會報 400？

推理力度不是 none 時，temperature、top_p、top_logprobs 都不能傳。要麼刪掉這些參數，要麼把 effort 設爲 none。

Q5：沒充值能測試嗎？

可以。在 API易 apiyi.com 註冊的新賬號自帶 0.05 美元試用額度，足夠跑通一次輕量調用。建議先用 `gpt-5.4-mini` 驗證鏈路，再切換到目標模型。

Q6：GPT-6.1 Terra 有哪些已知限制？

不支持 fine-tuning 和 predicted outputs，也不支持 Realtime、Assistants、Embeddings、Images、Audio 等端點。輸入超過 272K 會整單按第二檔計費，超過 922,000 tokens 會直接報 400。

GPT-6.1 Terra API 核心要點 Key Takeaways

  • 唯一關鍵選擇：要工具就用 Responses，否則 Chat 改個模型名即可
  • 三個參數坑：Chat 不帶 tools、用 max_completion_tokens、effort 非 none 時不傳採樣參數
  • 控制檯 5 步：註冊、建令牌選分組、Base URL 帶 /v1、填模型名、跑請求
  • 驗收信號：Key 以 sk- 開頭，請求返回 200 且 usage 有數字，model 字段回顯
  • 計價四要素：輸入、輸出、緩存讀取、緩存寫入，超過 272K 整單進入第二檔
  • 上手方式：先在 API易 用 gpt-6.1-sol 跑通鏈路，Terra 上架後只改模型名

總結

GPT-6.1 Terra API 接入的要點可以歸納爲三條：

  1. 端點先行：先決定用 Responses 還是 Chat，這決定了參數寫法和能否調用工具。
  2. 逐步驗收：令牌、Base URL、模型名、第一次請求，每一步都有明確的檢查信號。
  3. 成本心裏有數：272K 階梯按整單計算，緩存四項費用都要納入預算。

推薦先在 API易 apiyi.com 用 gpt-6.1-sol 跑通完整鏈路。截至 2026-10-27 平臺尚未上架 gpt-6.1-terra，我們會盡快推出此模型，型號與價格以平臺型號列表爲準。

📚 參考資料

  1. OpenAI 模型頁 – GPT-6.1 Terra：模型規格與端點支持
  2. 鏈接：platform.openai.com/docs/models/gpt-6.1-terra

  3. 說明：上下文、模態、可用工具的官方口徑

  4. OpenAI 最新模型指南：參數遷移與限制

  5. 鏈接：platform.openai.com/docs/guides/latest-model

  6. 說明：reasoning.effort、max_completion_tokens 等參數規則

  7. OpenAI 定價頁：階梯計價與緩存價格

  8. 鏈接：platform.openai.com/docs/pricing
  9. 說明：272K 兩檔與緩存寫入時長定價

作者：APIYI 技術團隊
技術交流：歡迎在 API易 網站首頁聯繫我們，更多接入說明可查閱 docs.apiyi.com 文檔中心

延伸閱讀

Similar Posts