FAQ

按照快速開始完成帳戶登入、建立 API Key、選擇模型和傳送最小請求。首次測試建議先使用 OpenAI Chat 相容呼叫，確認基礎鏈路成功後再增加串流輸出、工具呼叫或多模態輸入。

前往 API Keys 建立、停用或刪除權杖。不同環境建議使用不同的 Key；不再使用或疑似洩漏的 Key 應及時停用或刪除。

建議 Base URL 是 https://api.agtcloud.cn/v1。使用 OpenAI SDK 時，將它設定為 base_url 或 baseURL，OpenAI 相容介面通常使用 Authorization: Bearer your-api-key 認證。其他協議應以對應 API Reference 要求的身分驗證 Header 為準。詳細說明見 API Key、Base URL 與認證。

不建議。長期 API Key 應儲存在可信伺服器端、伺服器端環境變數或金鑰管理服務中。瀏覽器和行動裝置端應用應請求你自己的後端，再由後端呼叫 AGTCloud，避免使用者擷取和濫用 Key。

常見原因是 Base URL 已經包含 /v1，程式碼又在端點前重複新增了 /v1。建議使用 https://api.agtcloud.cn/v1 作為 SDK Base URL，再讓 SDK 自動串接 /chat/completions 等端點。疑難排解時檢查最終發出的完整 URL。

前往 模型廣場 檢視目前顯示的模型和模型 ID。模型可見範圍會隨平台設定和帳戶權限變化；呼叫時請複製目前頁面顯示的 ID，並以實際請求結果為準。

沒有必須保留的原廠協議語意時，可以先從 OpenAI Chat Completions 開始，因為它的 SDK 和串接方式比較普遍。已有 Anthropic、Gemini 或 Responses 應用時，應優先保留現有 SDK 和訊息結構，再確認目標模型的適配情況。

401 先檢查對應協議要求的身分驗證 Header 和 API Key；403 檢查帳戶、Key 和模型權限；404 檢查 Base URL、端點、模型 ID 或任務 ID。不要對這些錯誤無限重試，先修復明確原因。更多步驟見錯誤與疑難排解。

檢查回應標頭中的 x-request-id、request-id 或 x-oneapi-request-id，儲存實際存在的值。部分錯誤本文中也可能包含 Request ID；如果沒有找到，仍應記錄請求時間、Method、Path、模型和 HTTP 狀態。程式碼範例見 Request ID。

立即前往 API Keys 停用或刪除舊 Key，然後建立新 Key 並更新使用它的服務。檢查程式碼儲存庫、記錄、截圖和聊天記錄中是否仍有副本；如果曾提交到 Git，不要只刪除目前文件，還要按團隊安全流程處理歷史記錄。

準備請求時間和時區、Method、Path、模型 ID、HTTP 狀態、去識別化錯誤資訊、SDK 與執行時版本，以及最小重現步驟。回應中存在 Request ID 時一並儲存。不要提交完整 API Key、身分驗證 Header、Cookie、客戶 Prompt 或私有檔案。