轉接 API 常見問題：從拿金鑰到排查報錯

開始使用

怎麼拿到第一把金鑰？

打開取得金鑰頁，用信箱和密碼註冊，註冊完成後金鑰會立刻顯示在頁面上。整個過程不需要填寫任何支付資訊，複製下來放進環境變數就可以開始呼叫。

一個帳號能有幾把金鑰？

每個帳號一把。需要更換時可以重新產生，但要注意：重新產生之後舊金鑰會馬上失效，所有還在使用的舊金鑰的服務都會開始收到 401，所以請先準備好新金鑰的下發流程再操作。

介面位址和模型名分別是什麼？

位址是 https://api.llmzhongzhuan.com/v1，对话请求发往 /v1/chat/completions，模型清單用 GET /v1/models 查看。模型名只有一個，寫作 uncensored。

已有的 OpenAI 程式碼需要怎麼改？

通常只要改兩處：把 base_url 換成上面的位址，把金鑰換成本站的金鑰，再把 model 欄位改成 uncensored。請求體和響應體的結構保持 OpenAI 對話補全的格式，所以大部分程式碼不用動。具體框架寫法見 框架配置。

額度與計費

試用額度有多少，怎麼算？

新帳號贈送 0.50 美元，有效期 7 天。按輸入每百萬 token 0.25 美元、輸出每百萬 token 1.00 美元計算，假設每次請求輸入 800 token、輸出 400 token，一次約 0.0006 美元，試用額度大約能發 800 多次這樣的請求。這只是按假設做的估算，實際取決於你的提示詞長度。

儲值之後餘額會過期嗎？

不會。儲值的是預付額度，沒有訂閱，也沒有到期清零的規則。需要注意的只有試用額度，它在 7 天後失效。

怎麼知道一次請求花了多少？

響應裡帶有 usage，包含輸入和輸出的 token 數。串流請求時，最後會自動多出一個攜帶 usage 的分片。拿這兩個數字乘以單價即可得到該次費用，監控落盤的寫法可以參考 穩定性實踐。

完整價格在哪裡看？

價格以 定價頁 為準。頁面上寫明了輸入和輸出兩檔單價，沒有隱藏的按次費用。

報錯與限流

返回 402 是什麼意思？

錯誤碼為 no_credit，表示帳號餘額已經用完，或者試用額度已過期。解決辦法只有一個：儲值預付額度。這個錯誤不要重試，重試不會成功，只會產生多餘的請求。

返回 429 要怎麼處理？

每個金鑰每分鐘最多 300 次請求，超出就是 429。先降低發送速率，再加上帶隨機抖動的退避重試。批次處理建議用並行上限加節拍器來平滑發送，範例程式碼在穩定性那一篇裡。

503 upstream_busy 是故障嗎？

不是永久性故障，意思是服務暫時繁忙。幾秒之後重試通常就能成功，建議使用指數退避，並限制最多重試的次數。

403 content_blocked 是怎麼回事？

說明這次請求觸發了內容攔截。涉及未成年人的性內容無論是否為虛構、角色扮演，都會一律返回 403。遇到 403 不要重試，請檢查並修改請求內容。

能力邊界

上下文有多長，輸出能寫多長？

上下文總長為 100,000 token，輸入和輸出合計不能超過它。max_tokens 預設 2048，單次最大可設到 32,000。輸入加 max_tokens 超過上限時會返回 400，寫長文時記得給輸入留出空間。

支援串流和工具呼叫嗎？

都支援。把 stream 設為 true 即可得到 SSE 串流輸出；工具呼叫採用 OpenAI 的 tools 格式。temperature、top_p、stop 這些常見採樣參數會被透傳。

能做向量、畫圖或語音嗎？

不能。本站只提供文字對話，沒有向量、圖像、音訊、影片和微調，也只有一個模型。如果業務需要這些能力，需要另外搭配其他方案。

請求體有大小限制嗎？

有，單個請求體不能超過 8 MB。把很長的文件放進提示詞時，除了 token 數，也要留意整體位元組數。

上線與日常維運

正式上線前最該做哪幾件事？

先用 /v1/models 確認模型清單，再跑一遍包含長輸入、串流輸出和錯誤路徑的測試。然後為 402、429、503 分別寫好處理分支，並把 usage 持久化。最後為餘額設一個提醒線，避免在高峰時段才發現額度見底。別忘了把這些檢查項寫進發布流程，由值班人員逐項確認。

線上突然全部返回 401，先查什麼？

先確認有沒有人在後台重新生成過金鑰，因為重新生成後舊金鑰會立刻失效。其次檢查環境變數是否在最近一次發布中丟失，或者金鑰裡被混入了空格和換行。把當前生效的金鑰只保存在一個地方，能省掉大部分此類排查。

多個服務共用一把金鑰，要注意什麼？

限流是按金鑰合併計算的，所有服務的請求加起來每分鐘不能超過 300 次。如果其中一個批處理任務把額度占滿，線上業務也會收到 429。建議給批處理單獨限速，把線上請求的優先級放在前面，必要時讓批處理在夜間錯峰執行。

怎樣避免費用悄悄超出預期？

輸出 token 的單價是輸入的四倍，所以優先控制 max_tokens 和提示詞裡要求的篇幅。再按功能統計 usage，一旦某個功能的平均輸出突然翻倍，就去檢查是不是提示詞改動引起的。預付額度模式的好處是餘額用完就停，不會出現意外的超額帳單。

內容與隱私

哪些內容會被允許？

合法的成人內容、虛構創作和有爭議的話題不會被直接拒絕，服務面向 18 歲以上的成年用戶。涉及未成年人的性內容則始終被攔截。關於這類服務的成本和取捨，可以讀 無限制 AI API 的成本與權衡。

我的提示詞會被拿去訓練嗎？

不會，提示詞不會被用於訓練。除此之外，本頁不對其他存儲或日誌細節作出說明，請以文件為準。

這個服務和聚合型中轉有什麼不同？

本站只提供一個模型，沒有大量模型名需要映射，模型清單可以透過 /v1/models 自己核對。想了解中轉的一般原理與風險，可以先讀 中轉原理 那一篇。