開啟 VS Code 前你需要準備什麼
用於 VS Code 的 qwen api 金鑰僅需 API 金鑰以及擴充功能中的正確端點設定。請先收集這三個值:
- Base URL:
https://api.uncensoredqwen.com/v1 - 模型 ID:
uncensored - API 金鑰: 在透過 Google 或電子郵件與密碼註冊後,於 API 金鑰頁面 建立
新帳戶可以在該頁面以一次點擊領取 $0.50 的試用額度。它不需要信用卡,每人限領一次,且有效期為 7 天。這足以讓你在幾天內的實際程式碼編寫中測試編輯器設定。
命名注意事項:此服務是由獨立業者託管的開放權重模型,並非阿里巴巴的官方 API,也不是用於轉發請求的路由器。在你的編輯器中,它會以你設定的顯示名稱呈現。
先用 curl 測試金鑰
在更改任何編輯器設定之前,請確認金鑰和 URL 單獨運作正常。如果此步驟失敗,任何擴充功能都無法成功,且你會知道問題出在金鑰而非外掛程式。
export API_KEY="paste-your-key-here"
curl https://api.uncensoredqwen.com/v1/models \
-H "Authorization: Bearer $API_KEY"
包含 uncensored 的 JSON 清單表示驗證運作正常。然後傳送一次實際的補全請求:
curl https://api.uncensoredqwen.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python function that reverses a string."}],"max_tokens":200}'
回應標頭包含 X-Balance-USD,這是無需離開終端機即可查看剩餘額度的快速方法。
在 VS Code 擴充功能中新增提供者
多個用於 AI 程式輔助的 VS Code 擴充功能可連接到任何 OpenAI 相容的伺服器。標籤因工具而異,但欄位是一一對應的。請尋找名為「OpenAI 相容」、「OpenAI」(搭配自訂基礎 URL)或「自訂端點」的提供者選項。
| 擴充功能欄位 | 要輸入的值 |
|---|---|
| 供應商 | OpenAI 相容(或帶有自訂基礎 URL 的 OpenAI) |
| 基礎 URL / API 基礎 | https://api.uncensoredqwen.com/v1 |
| API 金鑰 | 你帳戶中的金鑰 |
| 模型 ID | uncensored |
讀取 JSON 設定檔的擴充功能通常希望看到類似這樣的格式。確切的鍵名可能有所不同,請檢查你擴充功能的文件並調整欄位名稱:
{
"models": [
{
"title": "Uncensored API",
"provider": "openai",
"model": "uncensored",
"apiBase": "https://api.uncensoredqwen.com/v1",
"apiKey": "paste-your-key-here"
}
]
}
不要將此檔案提交。如果你的設定位於儲存庫內,請使用擴充功能的機密儲存或環境變數,並將設定路徑新增至 .gitignore。
儲存後,開啟擴充功能的聊天面板並傳送短訊息(例如「解釋這個函式」),同時開啟一個檔案。串流輸出的答案表示設定已完成。
修復常見的設定錯誤
大多數設定失敗都歸因於少數幾個打字錯誤。請按順序檢查以下清單。
URL 格式不正確
Base URL 應以 /v1 結尾。擴充功能會自行新增 /chat/completions。如果你貼上完整路徑,會得到 404 錯誤,因為客戶端會請求 /v1/chat/completions/chat/completions。結尾的斜線通常無害,但缺少 /v1 則不行。
模型名稱不正確
部分擴充功能會從其他服務預填模型下拉選單。請以 uncensored(全小寫)覆寫它。如果欄位是沒有自訂選項的下拉選單,請尋找「自訂模型」或「其他」選項。
金鑰包含多餘字元
從網頁複製可能會附加尾隨空格或換行符。請貼到純文字編輯器中,修剪後再次貼上。401 回應幾乎總是指向此問題或來自不同帳戶的金鑰。
擴充功能仍在與其預設伺服器通訊
如果在聊天請求後你的餘額沒有變化,編輯器可能正在使用內建提供者。請確認活躍的模型設定檔是你編輯過的那個,並在更改設定後重新載入視窗。
請求因 429 錯誤失敗
這是速率限制,將在下一節介紹。錯誤內文包含指出你觸及哪個限制的程式碼。
確認請求確實到達 API
編輯器很少告訴你哪個伺服器回應。兩個快速檢查可以消除疑慮。
- 監控餘額。 從終端機執行
/v1/models或短補全呼叫,記錄X-Balance-USD標頭,在編輯器中傳送三則聊天訊息,然後重複終端機呼叫。數字應減少一小筆金額。該數字也可從GET /v1/balance取得。 - 請求一個預設設定會拒絕或不同處理的內容。 一個微小且無害的測試是請求恰好五個字的回覆。如果回答遵循指示並以串流輸出形式返回,表示連線健康。
如果餘額沒有變動,請開啟擴充功能的輸出面板或開發者主控台。大多數擴充功能會記錄請求 URL 和 HTTP 狀態碼,錯誤的主機名會立即顯示。修正 Base URL,重新載入視窗並再試一次。
共享儲存庫的團隊應讓每個人擁有獨立的金鑰,而不是共用一個值。這樣一來,一個人觸及速率限制不會阻礙其他人,且洩漏的金鑰可以更換而不影響其他人。
自動完成、聊天與速率限制
聊天對限制很溫和:每個訊息一個請求。內嵌自動完成則不同。許多擴充功能會在輸入暫停時發送請求,這可能會在你工作時產生每分鐘數十次呼叫。
了解這些數字。完整金鑰允許 8 個並行請求和每分鐘 300 個請求。試用金鑰允許 2 個並行和每分鐘 60 個請求。當超過這些限制時,API 會回覆 HTTP 429 以及程式碼 rate_limited(每分鐘過多)或 concurrency(同時過多)。在暫時過載時,你也會收到帶有 Retry-After: 5 標頭的 429 回應。串流補全請求會保留其並行槽位直到串流結束,因此慢速串流會更長時間佔用並行槽位。
實用的設定建議:
- 使用服務進行聊天、編輯和解釋,並在試用金鑰期間關閉 Tab 自動完成或增加其去抖延遲時間。
- 降低自動完成的最大輸出 token 數量至幾十個。短補全會快速完成並釋放槽位。
- 在試用期間,避免對同一個金鑰執行多個編輯器視窗。
失敗或拒絕的請求不會計費,因此錯誤僅消耗時間,不會產生費用。
程式碼工作階段的成本
程式碼提示詞的輸入量較大,因為擴充功能會附加檔案內容。定價為每 100 萬個輸入 token $0.15,每 100 萬個輸出 token $0.50。考慮一次對話輪次:發送 6,000 個 token 的程式碼與上下文,並接收 800 個 token 的回應:
- 輸入:6,000 x $0.15 / 1,000,000 = $0.0009
- 輸出:800 x $0.50 / 1,000,000 = $0.0004
- 總計:每回合 $0.0013
在工作日進行 100 次此類對話需花費 $0.13。$0.50 的試用額度涵蓋約 380 次此類對話($0.50 / $0.0013 約為 385)。額度為預付制,不會過期,儲值金額為 $20 至 $500 的整數,滿 $50 贈 5%,滿 $100 贈 10%,滿 $200 贈 15%。請參閱 定價頁面 了解付款方式。
上下文視窗為 100,000 個 token,包含提示詞與補全內容。若擴充功能將整個程式庫索引至每個提示詞中,大型請求的成本會更高並接近此上限。請將上下文縮減至實際需要的檔案。
隱私與更多資訊
提示詞不會用於訓練。然而,原始程式碼通常包含機密資訊,因此請將 .env 檔案和憑證與你附加至對話的檔案分開。大多數擴充功能允許你將特定路徑排除在上下文之外。
該模型僅支援文字。它可回答程式碼問題、撰寫函式、解釋錯誤,並支援函式呼叫與 JSON 模式,但不生成圖片、音訊或影片。如需此頁面以外的請求欄位與範例,請閱讀API 文件。若經過上述檢查後仍有問題,先前關於常見 Qwen API 錯誤的文章列出了更多錯誤模式與解決方法。
