Uncensored API 常見問題

基礎知識

Uncensored API 用一句話怎麼說？

這是一個付費、僅文字聊天補全端點，提供單一模型，id 為 uncensored，不拒絕合法成人內容、小說或爭議性主題。

我該呼叫哪個 URL？

使用 https://api.uncensoredapis.com/v1 作為 Base URL。聊天請求送往 POST /v1/chat/completions，模型列表位於 GET /v1/models。其他路徑回傳 404。

我需要學習新的 SDK 嗎？

不需要。請求與回應格式遵循通用聊天補全慣例，因此官方 Python 和 Node 套件在更改 Base URL 和金鑰後即可使用。Plain curl 也可用，如 文件所示。

有辦法在付費前試試看嗎？

有。新帳戶獲得 $0.50 試用額度，有效期 7 天，註冊時不需付款資訊。在 金鑰頁面以電子郵件和密碼註冊，金鑰將立即顯示。

我可以選擇多個模型嗎？

不行。只有一個模型，其 id 為 uncensored。呼叫模型路由會回傳該單一項目，因此無須選擇或切換。

這項服務適合誰？

為成人開發產品的開發人員，包括小說工具、角色扮演應用程式與研究助理。你需自行負責年齡驗證與內容規則，以及你在其上發布的內容。

金鑰與存取

帳戶可以獲得多少支金鑰？

一支。如果需要新值，請從帳戶重新產生；舊金鑰會同時失效，請立即部署替換金鑰。

金鑰應放在哪裡？

保留在你控制的伺服器上的環境變數或機密管理器中。瀏覽器 JavaScript 和行動應用程式可被檢查，因此請透過你自己的後端路由客戶端流量，而非嵌入金鑰。

金鑰如何傳送？

在每個請求的 Authorization: Bearer 標頭中。缺少或錯誤的值會回傳 401 與 JSON 錯誤物件。

我想要一支團隊用的無審查 API 金鑰。我們可以共用一支嗎？

可以，但每個處理程序共用相同的每分鐘 300 次請求限制與餘額。在金鑰前放置小型閘道器，讓每位隊友存取閘道器而非金鑰本身。

限制與計費

提示詞可以多大？

上下文視窗為 100,000 token，由提示詞與補全共用。單一請求的主體不得超過 8 MB。若提示詞加上 max_tokens 超過視窗，請求將以 400 拒絕。

回覆可以多長？

預設為 2048 token。你可以將 max_tokens 提高至每請求最多 32,000。當回答因上限停止時，finish_reason 讀取為 length。

費用是多少？

輸入 token 為每百萬 $0.25，輸出 token 為每百萬 $1.00。餘額為預付，無訂閱，餘額永不過期。請參閱 計費頁面查看表格。

可以給個快速估算嗎？

假設聊天回合包含 1,500 提示 token 與 300 補全 token，僅供說明。輸入為 $0.000375，輸出為 $0.0003，或每回合約 $0.000675，因此 $1 可購買約 1,480 次此類回合。

當我發送過多請求時會發生什麼事？

每支金鑰每分鐘可發送 300 次請求。超出後會收到 429，正確做法是減速並帶有延遲地重試。

整合問題

我可以設定哪些採樣參數？

temperature、top_p 與 stop 等標準參數會直接傳遞至生成階段。請在請求主體中按照一般方式設定它們。

API 會替我記住之前的對話輪次嗎？

不會。每個請求都是獨立的，因此每次都需要在 messages 中重新傳送對話內容。當總 token 數接近 100,000 的上下文視窗上限時，請裁減最舊的輪次。

我可以將 token 串流輸出至瀏覽器嗎？

可以，請傳送 stream: true 並讀取伺服器推送事件（SSE）。建議從後端執行，並將文字轉發至網頁，這樣 API 金鑰就不會暴露在客戶端。

支援系統提示詞嗎？

支援。請在陣列的第一個位置放入角色為 system 的訊息，以設定對話的語氣、格式與邊界。

當輸出被截斷時，我應該先檢查什麼？

請檢查 finish_reason。若值為 length，表示已達到上限，請提高 max_tokens 或縮短提示詞。參考文件列出了所有可能的值。

餘額與帳單

我如何儲值？

從你的帳戶為預付額度儲值。無需訂閱，未使用的額度始終可用，因為它永不過期。

當免費試用額度耗盡時會發生什麼事？

試用額度有效期為 7 天。額度耗盡或過期後，請求將返回 402 錯誤，代碼為 no_credit，直到你為餘額儲值為止。

我可以查看請求的成本嗎？

每個回應都包含一個 usage 區塊，其中顯示提示詞、完成內容與總 token 數。將其乘以每百萬 token 的費率即可得出費用。若您希望建立帳冊，請自行記錄總計。

失敗的請求可以免費重試嗎？

允許重試，但請控制重試次數。對於 429 和 503 錯誤，請使用短延遲退避機制；對於 400、401、402 或 403 錯誤，請勿無限循環重試，因為這些錯誤不會自行修復。錯誤處理指南提供了現成的策略。

內容與行為

該模型不會做什麼？

合法的成人內容不會被拒絕，小說或具爭議性的主題亦然。唯一的例外是涉及未成年人的性內容，這類內容每次都會被拒絕並返回 403 狀態碼，無論是在故事還是角色扮演中。該服務僅供 18 歲以上成人使用。

我的提示詞會用於訓練模型嗎？

不會。提示詞不會用於訓練。

這與透過聚合器路由有何不同？

聚合器會將請求轉發至多個模型，每個模型都有其自身的規則。此服務僅有一個模型，遵循單一政策。無審查 OpenRouter 指南詳細介紹了此項比較。

它能否處理影像或生成嵌入向量？

不能。它僅處理文字，不支援嵌入向量、影像、音訊、影片或微調。

故障排除

我收到 402 與 no_credit 錯誤，該怎麼辦？

你的餘額已耗盡或試用已過期。請為預付額度儲值，然後再次發送請求。

請求返回 503 upstream_busy。

這是暫時性的。請等待幾秒後重試。若您運行多個工作程序，請使用遞增的延遲時間並加入一些隨機性。

我的串流輸出結束了，但找不到 token 計數。

啟用串流輸出時，系統會自動在 data: [DONE] 之前加入一個包含 usage 的最後一個區塊。該區塊的 choices 列表為空，因此在索引前請先檢查此情況。

工具與函式呼叫運作正常嗎？

是的，採用標準格式：傳遞 tools 陣列，並在回覆中檢查 tool_calls。