GLM API 金鑰：故障排除指南
您的 GLM API 金鑰是否返回錯誤或無法整合至您偏好的編輯器？本指南解決最常見的設定問題，從「Unauthorized」回應到串流解析錯誤，確保您的無審查 LLM 呼叫可靠運作。
摘要
- 驗證您的基礎 URL 與模型 ID 是否與用戶端設定完全相符，以避免出現「Unauthorized」或「Model Not Found」錯誤。
- 透過 SSE 串流回應需要解析最後一個區塊以獲取計費資料，因為計費資料不會包含在每個訊息區塊中。
- 預付加密貨幣模型僅對成功的 token 生成收費，使錯誤與拒絕生成的請求實際上免費。
- 上下文窗口結合提示詞與補全，因此 100k 的限制意味著您必須仔細計算輸入與輸出的 token。
為何您的金鑰返回 'Unauthorized'
'Unauthorized'（未授權）錯誤通常源於配置的 API 金鑰與基礎 URL 端點不匹配。當將新 LLM 整合到 Zed 或 Trae 等編輯器時，您必須確保基礎 URL 直接指向提供者的聊天完成端點，而非通用代理。如果您使用的是 OpenAI 相容客戶端，我們服務的基礎 URL 為 HTTPS://api.apiglm.com/v1。傳遞錯誤的 URL 或過期的金鑰會立即觸發此 401 回應。
另一個常見原因是以錯誤的標頭格式傳送金鑰。某些客戶端期望 'Authorization: Bearer '，而其他客戶端可能會誤解輸入欄位。請確認您的金鑰與登入 Google 或電子郵件後儀表板上顯示的完全一致。沒有電話號碼驗證步驟，因此如果金鑰有效，它應能在任何標準 OpenAI SDK 實作中運作。
- 檢查基礎 URL 是否以 /v1 結尾。
- 確保 URL 字串中無尾隨斜線。
- 驗證金鑰未被撤銷或替換。
處理「思考區塊」問題
使用推理型模型的用戶常遇到空的「思考」區塊，模型輸出了標籤但沒有文字。這不一定是程式碼的錯誤，而是底層無審查模型架構的行為。模型可能會輸出包含空白字元或空字元的推理區塊，您的解析器可能會將其解讀為空回應。
要處理此問題，請將您的客戶端配置為忽略空的推理標籤或在處理前去除空白。如果您使用的是自訂推理轉換器，請確保它能正確處理這些邊緣情況。該模型針對直接答案進行了調整，因此過多的思考區塊有時表明需要調整 'temperature' 或 'top_p' 參數以鼓勵更直接的回應。
除錯此問題需要記錄原始回應位元組。如果思考區塊存在但為空，可以安全地跳過它並繼續實際內容生成。這可確保您的應用程式不會因等待不存在的文字而掛起。
配置編輯器中的基礎 URL
將無審查 LLM 整合到 Zed 或 Claude Code 等本地編輯器中需要覆蓋預設的環境變數。大多數編輯器預設使用 OpenAI 的基礎網址。您必須在設定檔中明確將基礎網址設定為 HTTPS://api.apiglm.com/v1。
對於 .env.development 或 config.js 檔案，請確保 API 金鑰變數已正確對應。例如，將 base URL 變數設定為指向我們的端點。這能確保所有請求（包括函式呼叫與串流傳輸）都通過我們的基礎設施路由。如果編輯器不支援自訂 base URL，您可能需要使用代理伺服器或包裝腳本，將標準 OpenAI 協議轉換為我們的端點。
透過發送簡單的 'ping' 請求來驗證整合。如果您收到有效的 JSON 回應，表示您的設定正確。在嘗試複雜的多輪對話之前，此步驟至關重要。
速率限制與併發錯誤
我們的基礎設施實施嚴格的速率限制，以確保高用量期間的穩定性。每個 API 金鑰限制為每分鐘 300 次請求，最多可處理 8 個同時請求。如果你超過這些限制，將收到 429 Too Many Requests 錯誤。
要避免這些錯誤，請在客戶端程式碼中實現指數退避機制。如果回應中包含 'Retry-After' 標頭，請監控該標頭。此外，確保您的應用程式在高峰時段不會出現流量尖峰。如果您運行多個執行個體，請將負載分佈到不同的金鑰上，或在應用程式層級管理並行性。
請求主體大小也限制為 8 MB。大型提示或大量工具調用可能會超過此限制。拆分您的輸入或減少並發請求數量以保持在這些限制內。這些限制是透明的，旨在防止資源耗盡。
Token 計數與上下文視窗
了解 token 使用對於成本管理至關重要。我們的模型支援 100,000 token 的上下文視窗，包含提示詞與補全內容。每次請求的最大輸出為 16,000 token，若未指定 'max_tokens' 則為 2,048 token。
定價基於實際 token 使用量：輸入 token 每百萬個 $0.15，輸出 token 每百萬個 $0.50。錯誤與拒絕請求均免費，因此您只需為成功的內容生成付費。此預付模式意味著您的信用額度永不過期，且您可以隨時透過加密貨幣充值。
透過解析回應中繼資料在您的應用程式中追蹤 token 用量。串流回應的最後一個區塊包含總 token 計數。這使您能夠即時監控成本，並調整提示以保持在預算內。高效的 token 使用是最大化預付額度價值的關鍵。
串流回應解析
串流回應透過伺服器發送事件（SSE）傳送。每個區塊包含回應的一部分，但 token 用量資料僅包含在最後一個區塊中。這意味著您必須等到串流完成才能計算總 token 用量。
透過監聽 'data' 事件來解析串流。累積文字區塊以形成完整回應。當您收到最後一個區塊時，提取 'usage' 欄位以更新本地的 Token 計數。這種方法確保了準確的計費，並有助於監控資源消耗。
優雅地處理網路中斷。如果串流斷開，您可能需要重試請求。確保您的客戶端能夠處理部分回應並正確重新組裝它們。串流非常適合即時應用程式，但需要強大的錯誤處理。
函式呼叫參數錯誤
函式呼叫需要精確的參數配置。確保您的 'tools' 陣列正確定義函式結構描述，包括參數和說明。'tool_choice' 參數可以設定為 'auto'、'required' 或特定的函式名稱。
常見錯誤包括工具模式中缺少必填字段或數據類型不正確。請驗證您的客戶端是否將 'response_format' 發送為 'json_object'（如果您期望結構化輸出）。這可確保模型返回您的應用程序可以解析的有效 JSON。
先使用簡單工具測試函式呼叫。逐漸增加複雜度以識別任何結構描述不匹配的情況。如果模型未能呼叫工具，請檢查回應中的 'tool_calls' 欄位以查看錯誤。正確的設定對於可靠的函式呼叫至關重要。
加密貨幣充值延遲修復
透過加密貨幣充值額度，具體為 USDT (TRC20) 或 USDC (Base)。交易可能需要幾分鐘才能在區塊鏈上確認。如果額度未立即顯示，請等待網路確認。
贈額會針對 $50 或以上的充值自動套用：$50 享 +5%、$100 享 +10%、$200 享 +15%。請匯入精確金額以獲得正確的贈額。低於 $20 或高於 $500 的交易可能無法獲得贈額或遭拒。
如果您遇到重複扣款，請透過支援頁面聯繫支援團隊。信用額度不退款但可調整。保留您的交易 ID 記錄以加快解決速度。這種預付模式確保您不會因過期而損失信用額度。
模型 ID 配置錯誤
使用錯誤的模型 ID 是常見的錯誤來源。對於我們的無審查模型，ID 僅為 'uncensored'。發送帶有 'gpt-4' 或 'claude-3' 的請求將導致「找不到模型」的錯誤。
確保您的客戶端在每個請求中明確將 'model' 欄位設為 'uncensored'。當使用可能會預設為其他模型的 OpenAI 相容 SDK 時，這至關重要。請驗證設定檔和測試請求中的模型 ID。
我們的服務不提供模型路由或多種模型選擇。它是專為 uncensored 文字生成設計的單一模型端點。這種簡化降低了複雜性並確保一致的效能。在部署至生產環境前，請務必再次確認模型 ID。
常見問題
我如何取得 GLM API 金鑰？
您可以在我們的「取得 API 金鑰」頁面透過 Google 或電子郵件與密碼註冊來產生 API 金鑰。金鑰在建立後會立即顯示。無需手機號碼，您將獲得 $0.50 的試用餘額，有效期為 7 天。
這是官方的 GLM API 嗎？
否，我們是一家獨立供應商，提供無審查、OpenAI 相容的 API。我們不提供來自各自廠商的官方 GLM 模型。我們的服務是一個獨立的基礎設施，旨在為單一無審查模型提供高吞吐量、低延遲的文字生成。
如果我在請求時收到錯誤會發生什麼事？
錯誤免費。您只為成功生成並在回應中返回的 token 付費。如果請求因速率限制、網路問題或模型錯誤而失敗，您無需為這些 token 付費。
我可以將自己的基礎 URL 搭配 OpenAI SDK 使用嗎？
是的，您可以配置任何 OpenAI 相容的 SDK，將 base URL 設定為 HTTPS://api.apiglm.com/v1 並提供您的 API 金鑰。這允許您使用與其他模型相同的客戶端程式碼，確保沒有供應商鎖定。
