連接團隊已經在使用的工具。

先準備清晰的存取路徑。

可靠的整合需要明確負責人、已核准模型，以及可隨時撤銷而不必修改應用程式碼的金鑰。

• 確認負責人. 指定工作台或專案負責人，負責核准模型、查看用量並處理被阻擋的請求。
• 核准模型. 查看模型目錄，確認能力、上下文與供應商路徑符合工作流程。
• 設定配額. 連接共用編輯器、Agent 或服務前，先為金鑰或團隊設定明確用量邊界。

為日常 AI 工作提供統一管理路徑。

從編輯器、終端機或相容 API 用戶端使用 TokenDate，讓不同工具共用同一套存取邊界。

• VS Code. 編輯器內 AI 工作流程
• Codex. Agent 與終端工作流程
• Claude Code. Anthropic 相容工作流程
• Trae. AI 原生編輯器工作流程
• Zcode. 程式助理工作流程
• 相容客戶端. OpenAI 相容設定

讓憑證與請求行為保持可控。

開發者應能輕鬆測試，管理員也應能清楚覆核整合狀態。

• 使用伺服器端金鑰. 將 TokenDate API 金鑰放在環境變數或金鑰管理器中，不要放入瀏覽器程式碼、儲存庫或請求記錄。
• 匹配請求格式. 依模型系列選擇相容端點，並在請求內容中保持模型識別碼與必要欄位正確。
• 先測試小型請求. 從低流量的代表性請求開始，確認回應、用量記錄、配額行為與錯誤處理後再發布。

從設定連線到受控輸出。

1. 選擇已核准的模型. 根據工作流程選擇組織已開放的模型與能力。
2. 設定相容端點. 使用 TokenDate 端點與託管 API 金鑰設定用戶端。
3. 查看用量上下文. 透過請求記錄、配額與用量資料了解工作流程，再擴大存取範圍。

應該從哪裡開始？

從一個有負責人、已核准模型與測試金鑰開始。在非生產環境驗證回應和用量記錄，再逐步擴大範圍。

如何選擇 Base URL 和端點？

使用工作台提供的 TokenDate Base URL，並依模型系列選擇相容端點。當前路徑、標頭和欄位請查看 API Reference。

API 金鑰應該放在哪裡？

放在伺服器端或用戶端工具的金鑰儲存中，盡量透過環境變數注入。不要暴露在前端建置產物、原始碼、截圖或記錄中。

OpenAI、Anthropic 和 Gemini 格式可以互換嗎？

並非所有模型都能互換。TokenDate 在適用情況支援 Chat Completions、Responses、Anthropic Messages 和 Gemini GenerateContent，請先確認模型和端點文件。

如何確認哪些模型可用？

同時查看模型目錄和工作台權限。模型出現在目錄中，不代表已被管理員授權給你的團隊或金鑰。

遇到 401、403、404 或 429 怎麼辦？

401 檢查金鑰和標頭，403 檢查權限或模型存取，404 檢查路徑與模型相容性，429 檢查配額或速率限制。持續失敗時保留請求 ID 並查看 API Reference 或聯絡支援。

生產環境如何處理限制？

上線前設定配額，對暫時錯誤使用帶退避的有限重試，並監控用量和錯誤率。不要盲目重試認證或權限錯誤。

什麼時候應該查看 API Reference？

需要精確端點路徑、標頭、請求結構、串流行為、媒體欄位或供應商限制時查看它。本頁說明接入流程，Reference 定義具體契約。