VI ▾
Lấy khóa API

uncensoredqwen.comHướng dẫn

Khóa API Qwen cho VS Code: Thiết lập Endpoint tùy chỉnh

Để sử dụng khóa api qwen cho VS Code, bạn không cần plugin cụ thể của Alibaba. Bất kỳ tiện ích nào hỗ trợ nhà cung cấp tương thích OpenAI đều chấp nhận ba giá trị: URL cơ sở, khóa và tên mô hình. Hướng dẫn này cung cấp các giá trị chính xác và các bước kiểm tra để bắt các lỗi thường gặp.

Cập nhật

Bảng chỉnh sửa mã đẳng cự với một chìa khóa vàng được cắm vào ổ endpoint liên kết với máy chủ

Những gì bạn cần trước khi mở VS Code

Khóa api qwen cho VS Code chỉ là một khóa API cộng với các cài đặt endpoint phù hợp trong một tiện ích. Hãy thu thập ba giá trị này trước:

  • URL cơ sở: https://api.uncensoredqwen.com/v1
  • ID mô hình: uncensored
  • Khóa API: được tạo trên trang khóa API sau khi bạn đăng ký bằng Google hoặc bằng email và mật khẩu

Tài khoản mới có thể nhận $0,50 tín dụng dùng thử chỉ với một cú nhấp chuột trên trang đó. Nó không cần thẻ, giới hạn một lần cho mỗi người và có hiệu lực trong 7 ngày. Điều đó đủ để bạn kiểm tra cấu hình trình soạn thảo trong vài ngày lập trình thực tế.

Lưu ý về cách đặt tên: dịch vụ là một mô hình trọng số mở được lưu trữ và vận hành bởi một nhà cung cấp độc lập. Nó không phải là API chính thức của Alibaba, và nó không phải là trình định tuyến đến các nhà cung cấp khác. Trong trình soạn thảo của bạn, nó hiển thị dưới bất kỳ tên hiển thị nào bạn đặt cho nó.

Kiểm tra khóa với curl trước

Trước khi thay đổi bất kỳ cài đặt trình soạn thảo nào, hãy xác nhận khóa và URL hoạt động độc lập. Nếu điều này thất bại, không tiện ích mở rộng nào hoạt động được, và bạn sẽ biết vấn đề nằm ở khóa chứ không phải plugin.

export API_KEY="paste-your-key-here"

curl https://api.uncensoredqwen.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

Một danh sách JSON bao gồm uncensored có nghĩa là xác thực hoạt động. Sau đó gửi một kết quả hoàn thành thực tế:

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}'

Các tiêu đề phản hồi bao gồm X-Balance-USD, đây là cách nhanh chóng để xem số dư còn lại mà không cần rời khỏi terminal.

Thêm nhà cung cấp trong tiện ích VS Code

Nhiều tiện ích mở rộng VS Code hỗ trợ AI có thể kết nối với bất kỳ máy chủ tương thích OpenAI nào. Các nhãn khác nhau một chút tùy công cụ, nhưng các trường khớp từng cặp. Tìm tùy chọn nhà cung cấp có tên như "OpenAI Compatible", "OpenAI" kèm URL cơ sở tùy chỉnh, hoặc "Custom endpoint".

Trường tiện íchGiá trị cần nhập
Nhà cung cấpTương thích OpenAI (hoặc OpenAI với URL cơ sở tùy chỉnh)
URL cơ sở / API cơ sởhttps://api.uncensoredqwen.com/v1
Khóa APIKhóa từ tài khoản của bạn
ID mô hìnhuncensored

Các tiện ích mở rộng đọc tệp cấu hình JSON thường yêu cầu một thứ có dạng như thế này. Tên chính xác của các khóa khác nhau, vì vậy hãy kiểm tra tài liệu của tiện ích mở rộng của bạn và điều chỉnh tên các trường:

{
  "models": [
    {
      "title": "Uncensored API",
      "provider": "openai",
      "model": "uncensored",
      "apiBase": "https://api.uncensoredqwen.com/v1",
      "apiKey": "paste-your-key-here"
    }
  ]
}

Không commit tệp này. Nếu cài đặt nằm trong kho lưu trữ, hãy dùng kho khóa bí mật của tiện ích hoặc biến môi trường thay thế, rồi thêm đường dẫn cấu hình vào .gitignore.

Sau khi lưu, mở bảng trò chuyện của tiện ích và gửi một tin nhắn ngắn như "Giải thích hàm này" với một tệp đang mở. Câu trả lời được truyền phát có nghĩa là cài đặt đã hoàn tất.

Khắc phục các lỗi cấu hình thường gặp

Hầu hết các cấu hình không thành công đều do một vài lỗi đánh máy. Hãy xem qua danh sách này theo thứ tự.

URL có hình dạng sai

URL cơ sở kết thúc tại /v1. Các tiện ích mở rộng tự thêm /chat/completions. Nếu bạn dán đường dẫn đầy đủ, bạn sẽ nhận được lỗi 404 vì máy khách yêu cầu /v1/chat/completions/chat/completions. Dấu gạch chéo cuối thường không gây hại, nhưng thiếu /v1 thì có.

Tên mô hình sai

Một số tiện ích điền trước menu thả xuống với tên mô hình từ dịch vụ khác. Ghi đè bằng uncensored chính xác, viết thường. Nếu trường là menu thả xuống không có tùy chọn tùy chỉnh, hãy tìm tùy chọn "custom model" hoặc "other".

Khóa có ký tự thừa

Sao chép từ trang web có thể thêm khoảng trắng hoặc dòng mới ở cuối. Dán vào trình soạn thảo văn bản thuần túy, cắt bớt và dán lại. Phản hồi 401 gần như luôn chỉ ra điều này hoặc khóa từ một tài khoản khác.

Tiện ích mở rộng vẫn giao tiếp với máy chủ mặc định của nó

Nếu số dư của bạn không thay đổi sau các yêu cầu trò chuyện, trình soạn thảo có thể đang sử dụng nhà cung cấp tích hợp. Hãy kiểm tra xem hồ sơ mô hình đang hoạt động là hồ sơ bạn đã chỉnh sửa, và tải lại cửa sổ sau khi thay đổi cài đặt.

Các yêu cầu thất bại với 429

Đó là giới hạn tốc độ, được đề cập ở phần tiếp theo. Phần thân của lỗi mang một mã cho biết bạn đã chạm giới hạn nào.

Kiểm tra xem các yêu cầu có thực sự đến API không

Các trình soạn thảo hiếm khi cho bạn biết máy chủ nào đã phản hồi. Hai bước kiểm tra nhanh loại bỏ nghi ngờ.

  1. Theo dõi số dư. Chạy /v1/models hoặc một lệnh gọi completion ngắn từ terminal, ghi chú tiêu đề X-Balance-USD, gửi ba tin nhắn chat trong trình soạn thảo, rồi lặp lại lệnh terminal. Số dư sẽ giảm đi một lượng nhỏ. Con số tương tự có thể lấy từ GET /v1/balance.
  2. Yêu cầu một thứ mà cài đặt mặc định sẽ từ chối hoặc xử lý khác. Một bài kiểm tra nhỏ, vô hại là yêu cầu một câu trả lời chính xác năm từ. Nếu câu trả lời tuân theo hướng dẫn và được truyền phát, kết nối khỏe mạnh.

Nếu số dư không thay đổi, hãy mở bảng ghi đầu ra của tiện ích hoặc console nhà phát triển. Hầu hết các tiện ích ghi lại URL yêu cầu và trạng thái HTTP, và máy chủ sai sẽ hiện ra ngay. Sửa URL cơ sở, tải lại cửa sổ và thử lại.

Các nhóm chia sẻ một kho lưu trữ nên cấp cho mỗi người một khóa riêng thay vì một giá trị dùng chung. Như vậy, giới hạn tốc độ do một người vi phạm không chặn những người khác, và khóa bị rò rỉ có thể được thay thế mà không làm ảnh hưởng đến những người khác.

Tự động hoàn thành, trò chuyện và giới hạn tốc độ

Trò chuyện nhẹ nhàng với giới hạn: một yêu cầu mỗi tin nhắn. Tự động hoàn thành nội tuyến khác biệt. Nhiều tiện ích gửi một yêu cầu khi tạm dừng ngắn trong khi gõ, điều này có thể tạo ra hàng chục lệnh gọi mỗi phút trong khi bạn làm việc.

Nắm rõ các con số. Khóa đầy đủ cho phép 8 yêu cầu đồng thời và 300 yêu cầu mỗi phút. Khóa dùng thử cho phép 2 yêu cầu đồng thời và 60 mỗi phút. Khi bạn vượt quá chúng, API trả về HTTP 429 và mã rate_limited (quá nhiều mỗi phút) hoặc concurrency (quá nhiều cùng lúc). Khi quá tải tạm thời, bạn cũng nhận được 429 kèm tiêu đề Retry-After: 5. Một kết quả hoàn thành được truyền phát giữ slot đồng thời của nó cho đến khi luồng kết thúc, vì vậy các luồng chậm tính vào bạn lâu hơn.

Các cài đặt thực tế giúp:

  • Sử dụng dịch vụ cho trò chuyện, chỉnh sửa và giải thích, và tắt tự động hoàn thành tab hoặc tăng độ trễ debounce trong khi trên khóa dùng thử.
  • Giảm số token đầu ra tối đa cho tự động hoàn thành xuống vài chục. Các lệnh gọi hoàn thành ngắn kết thúc nhanh và giải phóng slot.
  • Tránh chạy nhiều cửa sổ trình soạn thảo sử dụng cùng một khóa trong thời gian dùng thử.

Các yêu cầu bị lỗi hoặc từ chối không bị tính phí, vì vậy lỗi không tốn gì ngoài thời gian.

Chi phí cho một phiên lập trình

Các prompt mã hóa có lượng đầu vào lớn vì các tiện ích mở rộng đính kèm nội dung tệp. Giá là $0,15 cho mỗi 1M token đầu vào và $0,50 cho mỗi 1M token đầu ra. Hãy xem xét một lượt chat gửi 6.000 token mã và ngữ cảnh và nhận lại 800 token:

  • Đầu vào: 6.000 x $0,15 / 1.000.000 = $0,0009
  • Đầu ra: 800 x $0,50 / 1.000.000 = $0,0004
  • Tổng cộng: $0,0013 mỗi lượt

Với 100 lượt chuyển như vậy trong một ngày làm việc là $0,13. Tín dụng dùng thử $0,50 bao gồm khoảng 380 lượt chuyển có kích thước này ($0,50 / $0,0013 là khoảng 385). Tín dụng là tín dụng trả trước, không bao giờ hết hạn, và các khoản nạp tiền là số nguyên từ $20 đến $500, với tiền thưởng 5% từ $50, 10% từ $100 và 15% từ $200. Xem trang giá cả để biết phương thức thanh toán.

Cửa sổ ngữ cảnh là 100.000 token, bao gồm prompt và phần hoàn thành. Nếu một tiện ích mở rộng lập chỉ mục toàn bộ kho lưu trữ của bạn vào mỗi prompt, các yêu cầu lớn sẽ tốn nhiều chi phí hơn và tiếp cận giới hạn đó. Thu hẹp ngữ cảnh chỉ bao gồm các tệp bạn thực sự cần.

Quyền riêng tư và nơi đọc thêm

Các prompt không được dùng để huấn luyện. Tuy nhiên, mã nguồn thường chứa các bí mật, vì vậy hãy giữ các tệp .env và thông tin xác thực ra khỏi các tệp bạn đính kèm vào một cuộc trò chuyện. Hầu hết các tiện ích mở rộng cho phép bạn loại trừ các đường dẫn khỏi ngữ cảnh.

Mô hình chỉ hỗ trợ văn bản. Mô hình trả lời các câu hỏi về lập trình, soạn thảo hàm, giải thích lỗi và hỗ trợ gọi hàm cũng như chế độ JSON, nhưng không tạo hình ảnh, âm thanh hay video. Để xem các trường yêu cầu và ví dụ ngoài phạm vi trang này, hãy đọc tài liệu API. Nếu vẫn gặp lỗi sau khi đã kiểm tra các mục trên, bài viết trước về các lỗi API Qwen thường gặp sẽ liệt kê thêm các mẫu lỗi kèm cách khắc phục.

Hỏi đáp

Tôi lấy khóa API Qwen cho VS Code ở đâu?

Đăng ký trên trang web, mở trang khóa API và tạo một khóa. Bạn cũng có thể nhận tín dụng dùng thử $0,50 một lần nhấn ở đó, không cần thẻ.

Tôi nhập base URL nào vào tiện ích mở rộng?

Sử dụng https://api.uncensoredqwen.com/v1 và bỏ đi /chat/completions. ID mô hình là uncensored.

Tại sao tiện ích mở rộng của tôi trả về 401?

Khóa thường bị sai, có khoảng trắng thừa hoặc thuộc về một tài khoản khác. Sao chép lại khóa và kiểm tra với lệnh curl đến /v1/models.

Tôi có thể dùng nó cho tự động hoàn thành tab không?

Nó hoạt động thông qua các cài đặt tự động hoàn thành tương thích OpenAI, nhưng các yêu cầu thường xuyên có thể đạt đến giới hạn dùng thử 60 mỗi phút. Một khóa đầy đủ cho phép 300 mỗi phút.

Khóa của bạn chỉ cách một mẫu đăng ký

Tạo tài khoản, sao chép khóa, thay đổi URL cơ sở. Đó là toàn bộ thiết lập.

Lấy khóa API