Wu Xianzhi API常見問題
無審查 API 常見問題:註冊、計費、介面、錯誤碼與內容邊界
這裡整理了開發者在使用無審查 API 時最常問到的問題,依註冊與免費試用、計費與餘額、介面與參數、錯誤碼、內容邊界、隱私六類分組。介面相容 OpenAI 格式,只有一個模型 uncensored,依 token 預付費計費。想先看程式碼怎麼寫,可以去程式碼範例頁,想了解完整參數,可以查看介面文件。
更新於
重點
- 註冊只要信箱和密碼,不用綁卡,新帳號有 $0.50 試用額度,7 天內有效
- 價格是輸入 $0.25、輸出 $1.00 每百萬 tokens,預付費,餘額不會過期
- 上下文 100,000 tokens,max_tokens 預設 2048、最大 32,000,每個金鑰每分鐘 300 次請求
- 涉及未成年人的性內容始終攔截,限成年用戶與合法用途;提示詞不會用於訓練。
註冊與免費試用
怎麼註冊,需要綁定銀行卡嗎?
在 /get-api-key/ 頁面用電子郵件與密碼註冊即可,不需要綁卡。註冊成功後金鑰會立即顯示在頁面上,不用等待審核。
新帳號有多少試用額度,能用多久?
新帳號有 $0.50 試用額度,7 天內有效。依輸出 $1.00 / 百萬 tokens 算,大約夠產生 50 萬 tokens 的回應,用來做接入測試和小規模驗證是夠的。
一個帳號可以產生幾個金鑰?金鑰遺失怎麼辦?
每個帳號只有一個金鑰。如果洩漏或遺失,可以在帳號裡重新產生,舊金鑰會立刻失效,所有還在使用的服務都會收到 401,所以更換後要同步更新環境變數。
試用到期後會發生什麼?
試用額度过期後,請求會返回 402,錯誤碼是 no_credit。需要繼續使用時,給帳號儲值預付餘額即可,程式碼不用改。
計費與餘額
價格是多少,依什麼計費?
依 token 計費:輸入 $0.25 / 百萬 tokens,輸出 $1.00 / 百萬 tokens。沒有訂閱,也沒有月費,用多少扣多少。完整說明見 價格頁。
餘額會過期嗎?
不會。儲值的預付餘額沒有有效期,只有新帳號的 $0.50 試用額度有 7 天的時間限制。
怎麼知道一次請求花了多少錢?
每個回應的 usage 欄位會給出本次的輸入和輸出 token 數,乘以單價就是費用。串流請求的最後一個資料區塊裡也帶有 usage,讀取時注意這個區塊的 choices 是空陣列。
怎麼避免意外產生高額費用?
主要靠兩點:用 max_tokens 限制單次輸出,預設是 2048;多輪對話時裁剪歷史,別讓輸入越滾越長。因為是預付費,餘額用完請求就會停止,不會產生超出餘額的帳單。
舉個例子,一次普通請求大概多少錢?
假設輸入 2,000 tokens、輸出 500 tokens:輸入約 $0.0005,輸出約 $0.0005,合計約 $0.001,也就是一千次這樣的請求大約 $1。實際數字以回應裡的 usage 為準。
餘額用完后會怎樣?
介面返回 402,錯誤碼 no_credit。儲值後可以繼續使用,不需要重新產生金鑰。
介面與參數
介面地址和模型名是什麼?
Base URL 是 https://api.wuxianzhiapi.com/v1,模型名固定寫 uncensored。可用的介面有 POST /v1/chat/completions 和 GET /v1/models。
相容 OpenAI 的 SDK 嗎?
相容。官方 Python 的 openai v1 及以上、npm 的 openai v4 及以上,只要改 base_url 和金鑰就能用。具體寫法見 程式碼範例,從其他介面遷移可以看 遷移指南。
上下文有多長?max_tokens 能設多大?
上下文是 100,000 tokens,提示詞和輸出加起來不能超過這個數。max_tokens 預設 2048,單次最大 32,000。請求體不能超過 8 MB。
支援串流輸出和函式呼叫嗎?
都支援。串流用 stream: true,伺服器會在最後自動追加一個帶 usage 的資料區塊;函式呼叫使用 OpenAI 格式的 tools 和 tool_choice,工具結果以 role: "tool" 的訊息回傳。
為什麼串流回應的最後一塊沒有文字?
那是自動追加的用量統計區塊,choices 是空陣列,usage 裡是本次的 token 數。解析時先判斷 choices 是否為空再取內容,就不會報下標越界。
有速率限制嗎?
每個金鑰每分鐘 300 次請求。超過會返回 429,等待後重試即可,建議用指數退避。
支援向量、圖片、語音或微調嗎?
都不支援。這裡只提供文字對話,只有 uncensored 一個模型,沒有 embeddings,也沒有圖片、音訊、影片生成和微調。
錯誤碼
所有錯誤回應都是 JSON,格式為 {"error":{"code":...,"message":...}}。下面按狀態碼逐個說明該怎麼處理。
400 是什麼錯誤?
請求本身有問題,最常見的是提示詞加 max_tokens 超過了 100,000 tokens,或者 JSON 格式不對、欄位類型錯誤。需要修改請求,重試沒有用。
401 怎麼排查?
金鑰無效或未帶入。請檢查請求標頭是否為 Authorization: Bearer <金鑰>、環境變數是否已生效,以及金鑰是否曾被重新產生。舊金鑰在重新產生後會立即失效。
402 no_credit 是什麼意思?
餘額用完,或者試用額度已過期。給帳號儲值後即可恢復,不需要更換金鑰。
403 content_blocked 是什麼意思?
請求觸發了內容攔截。涉及未成年人的性內容始終會被攔截,包括虛構和角色扮演,這是不可調整的。修改請求內容後再試,原樣重發結果不會變。
404 是怎麼回事?
存取了不存在的端點。常見原因是 URL 寫錯,比如漏了 /v1,或者呼叫了不支援的端點,像 embeddings 和圖片生成。
429 和 503 該怎麼處理?
429 是超過了每分鐘 300 次的速率限制;503 的錯誤碼是 upstream_busy,表示模型暫時繁忙,幾秒後再試。兩者都適合用指數退避重試,範例見程式碼範例頁。
內容邊界
「無審查」是不是什麼都能生成?
不是。合法的成人內容、虛構創作和有爭議的話題不會被拒絕,但涉及未成年人的性內容始終會被攔截,返回 403,無論是否虛構、是否角色扮演。使用必須合法。
面向哪些用戶?
僅面向 18 歲以上的成年用戶。如果你用它做面向終端用戶的產品,需要在自己的應用程式裡做成年確認,並保留舉報和帳號管理機制。
可以用來做角色扮演、小說、遊戲嗎?
可以,這是最典型的用法。各場景的提示詞範例和成本估算見 應用場景 一文。
角色扮演裡什麼情況下會返回 403?
只有觸發內容攔截時才會返回,典型就是涉及未成年人的性內容,包括虛構設定。成年人之間的合法內容不會因為是角色扮演而被拒絕。遇到 403 時,請調整人設或情節後再請求。
模型輸出的事實一定可靠嗎?
不一定。不拒答不代表內容準確,涉及事實、數據、法律或醫療的結論,需要你自己核實後再使用。
隱私
我的提示詞會被用來訓練模型嗎?
不會。你發送的提示詞不會被用於訓練。
該怎麼保管金鑰?
把金鑰放在伺服器端的環境變數裡,不要寫進前端頁面、App 安裝檔或公開的程式碼倉庫。如果懷疑洩漏,立刻在帳號裡重新產生,舊金鑰會馬上失效。
應用程式裡的用戶數據該怎麼處理?
這部分取決於你自己的產品。建議只發送完成任務必需的內容,不要把使用者的真實姓名、證件號、聯絡方式等敏感資訊放進提示詞,並在隱私權政策裡寫清楚資料如何流轉。
常見問題
註冊需要銀行卡嗎?試用額度有多少?
不需要綁卡,使用電子郵件與密碼註冊後金鑰立即顯示。新帳號有 $0.50 試用額度,7 天內有效。
價格怎麼算,餘額會過期嗎?
輸入 $0.25 / 百萬 tokens,輸出 $1.00 / 百萬 tokens,預付費,沒有訂閱和月費。儲值的餘額不會過期,只有試用額度有 7 天限制。
上下文長度和 max_tokens 上限是多少?
上下文 100,000 tokens,提示詞和輸出合計。max_tokens 預設 2048,單次最大 32,000,請求體不超過 8 MB,每個金鑰每分鐘 300 次請求。
返回 402 或 403 是什麼原因?
402 的錯誤碼是 no_credit,表示餘額用完或試用已過期,儲值即可。403 的錯誤碼是 content_blocked,涉及未成年人的性內容始終會被攔截,包括虛構內容。
提示詞會被用於訓練嗎?
不會,提示詞不會被用於訓練。