確認負責人
指派一位工作區或專案負責人，負責核准模型、檢視用量，並在請求遭到封鎖時做出回應。
整合
連結團隊已在使用的工具。
將相容用戶端與 API 工作流程指向 New API 一次即可。在貴組織控管模型存取、用量與支出的同時，保留熟悉的工具。
連線之前
先備妥存取路徑。
可靠的整合始於明確的負責人、已核准的模型，以及可在不變更應用程式碼的情況下予以撤銷的金鑰。
核准模型
查閱模型目錄，確認其能力、脈絡與供應商路徑符合預期的工作流程。
設定配額
在連結共用的編輯器、Agent 或服務之前，先為金鑰或團隊設定明確的用量界線。
相容用戶端
為日常 AI 工作提供單一受管路徑。
從符合工作流程的編輯器、終端機或相容 API 用戶端使用 New API。
VS Code
以編輯器為基礎的 AI 工作流程
Codex
Agent 與終端機工作流程
Claude Code
Anthropic 相容工作流程
Trae
AI 優先的編輯器工作流程
Zcode
程式開發助理工作流程
相容用戶端
OpenAI 相容設定
審慎設定
讓憑證與請求行為保持可預期。
整合應讓開發者易於測試，並讓管理員易於審查。
使用伺服器端金鑰
將 New API API 金鑰儲存於環境變數或密鑰管理服務中。切勿將其放入瀏覽器程式碼、程式碼儲存庫或請求日誌。
選用相符的請求格式
選擇與模型系列相符的端點，並在請求主體中保留模型識別碼與必填欄位。
測試一筆小型請求
先以具代表性、低量的請求開始。在推行前確認回應、用量記錄、配額行為與錯誤處理。
Agent 協作調度
讓 Agent 透過單一受治理路徑呼叫工具。
Agent 可以規劃任務、擷取脈絡並呼叫已核准的模型，而 New API 則讓憑證、模型存取與請求軌跡都受到同一套營運控管。
任務請求
Agent
擷取脈絡
模型呼叫
已審查的結果
清楚的整合路徑
從設定到受治理的產出。
- 01
選擇已核准的模型
選擇貴組織已開放使用的模型與能力。
- 02
設定相容端點
以 New API 端點與受管 API 金鑰設定用戶端。
- 03
在脈絡中檢視用量
在擴大存取之前，先運用請求記錄、配額與用量資料。
整合常見問題
上線前的實用解答。
運用這些解答規劃第一次連線。API 參考文件仍為端點欄位與供應商特定行為的準則來源。
我們應該從哪裡開始？
先從一個有明確負責人的工作流程、一個已核准的模型與一把測試金鑰開始。在非正式環境中連線、驗證回應與用量記錄，再審慎擴展。
我們如何選擇 base URL 與端點？
使用為你的工作區提供之 New API base URL，並選擇與模型系列相符的相容端點。API 參考文件列出目前的路徑、必要標頭與請求欄位。
API 金鑰應該存放在哪裡？
將其保存在伺服器或用戶端工具的密鑰儲存區，並盡可能透過環境變數提供。請勿在前端打包檔、版本控制、螢幕截圖或日誌中曝露。
OpenAI、Anthropic 與 Gemini 的格式可以互換嗎？
它們並非對所有模型都可互換。New API 於適用時支援相容格式，包括 Chat Completions、Responses、Anthropic Messages 與 Gemini GenerateContent。切換格式前請查閱模型與端點文件。
我們如何得知有哪些模型可用？
請搭配使用模型目錄與你的工作區權限。模型可能出現在目錄中，但仍需管理員為你的團隊或金鑰授權。
遇到 401、403、404 或 429 錯誤時，我們該怎麼做？
401 請檢查金鑰與標頭，403 請檢查權限或模型存取，404 請檢查路徑與模型相容性，429 請檢查配額或速率限制。請保留請求 ID，若持續失敗，請查閱 API 參考文件或聯絡支援管道。
我們在正式環境中應如何處理各項限制？
上線前設定配額，針對暫時性回應採用有上限的退避重試，並監控用量與錯誤率。請勿盲目重試驗證或權限失敗的請求。
我們何時應該查閱 API 參考文件？
當你需要確切的端點路徑、標頭、請求結構描述、串流行為、媒體欄位或供應商特定限制時，請查閱該文件。本頁說明整合工作流程；參考文件則定義契約。