繁中 ▾
取得 API 金鑰

uncensoredqwen.com指南

Qwen API 金鑰用於 VS Code:自訂端點設定

要使用用於 VS Code 的 qwen api 金鑰,您不需要阿里雲專屬的外掛程式。任何支援 OpenAI 相容提供者的擴充功能都接受三個值:Base URL、金鑰和模型名稱。本指南提供確切的值以及用於捕捉常見錯誤的檢查步驟。

更新於

等距程式碼編輯器面板,金色金鑰插入連結至伺服器的端點插座

開啟 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 金鑰你帳戶中的金鑰
模型 IDuncensored

讀取 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

編輯器很少告訴你哪個伺服器回應。兩個快速檢查可以消除疑慮。

  1. 監控餘額。 從終端機執行 /v1/models 或短補全呼叫,記錄 X-Balance-USD 標頭,在編輯器中傳送三則聊天訊息,然後重複終端機呼叫。數字應減少一小筆金額。該數字也可從 GET /v1/balance 取得。
  2. 請求一個預設設定會拒絕或不同處理的內容。 一個微小且無害的測試是請求恰好五個字的回覆。如果回答遵循指示並以串流輸出形式返回,表示連線健康。

如果餘額沒有變動,請開啟擴充功能的輸出面板或開發者主控台。大多數擴充功能會記錄請求 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 錯誤的文章列出了更多錯誤模式與解決方法。

問答

我如何取得 VS Code 的 Qwen API 金鑰?

在網站上註冊,開啟 API 金鑰頁面並建立金鑰。你也可以在那裡一鍵領取 $0.50 試用額度,無需信用卡。

我應該在擴充功能中輸入什麼 Base URL?

使用 https://api.uncensoredqwen.com/v1 並省略 /chat/completions。模型 ID 為 uncensored。

為什麼我的擴充功能回傳 401?

金鑰通常有誤、包含多餘的空格,或屬於其他帳號。請重新複製金鑰,並使用 curl 呼叫 /v1/models 進行測試。

我可以將其用於 Tab 自動完成嗎?

它可透過 OpenAI 相容的自動完成設定運作,但頻繁請求可能會達到每分鐘 60 次的試用限制。完整金鑰允許每分鐘 300 次請求。

只差一張表單,即可取得金鑰

建立帳號、複製金鑰、更改基礎 URL。這就是整個設定過程。

取得 API 金鑰