Khóa API DeepSeek trong VS Code: Hướng dẫn thiết lập với API của chúng tôi

Tóm tắt nhanh

Bạn đã hỏi cách sử dụng khóa API deepseek trong vscode, và câu trả lời có hai phần. Thứ nhất, bản thân VS Code không nhận khóa API cho mô hình ngôn ngữ; một tiện ích mở rộng sẽ làm điều đó. Thứ hai, khóa từ trang web này không phải là khóa DeepSeek. Nó thuộc về một API độc lập, tương thích OpenAI, chạy một mô hình trọng số mở, được tinh chỉnh để trả lời mà không từ chối nội dung cho mục đích người lớn hợp pháp, và nó không phải là API chính thức của DeepSeek. Nếu bạn có khóa từ nền tảng của riêng DeepSeek, hãy nhập nó với endpoint của DeepSeek.

Đối với API này, mọi tiện ích đều cần ba giá trị giống nhau:

• URL cơ sở: https://api.deepseekapikey.com/v1
• Khóa API: khóa từ tài khoản của bạn, được gửi dưới dạng token Bearer
• Mô hình: uncensored

Các phần bên dưới cho bạn biết nơi đặt các giá trị đó trong Continue và các tiện ích thuộc họ Cline, sau đó cách kiểm tra xem mọi thứ có hoạt động không và duy trì chi phí có thể dự đoán được.

Trước khi bắt đầu: lấy khóa và kiểm thử

Đăng ký trên trang khóa API bằng Google hoặc bằng email và mật khẩu. Người dùng 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, có hiệu lực trong 7 ngày, một người dùng một lần, không cần thẻ. Nạp tiền trả trước bắt đầu từ $20.

Mở terminal tích hợp trong VS Code (Ctrl+` hoặc Cmd+`) và chạy một yêu cầu. Nếu điều này hoạt động, mọi lỗi sau đó là do cài đặt tiện ích chứ không phải do vấn đề với khóa.

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

curl https://api.deepseekapikey.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
  }'

Một phản hồi JSON có mảng choices có nghĩa là khóa, URL và tên mô hình đều đúng. Mã 401 có nghĩa là khóa không đúng. Mã 404 thường có nghĩa là đường dẫn sai. Bạn cũng có thể gọi GET /v1/models với cùng tiêu đề để kiểm tra nhanh với chi phí thấp.

Tùy chọn 1: tiện ích Continue

Continue là một tiện ích trợ lý mã nguồn mở cho VS Code cho phép bạn xác định các mô hình của riêng mình. Cài đặt nó từ chế độ xem Tiện ích, mở cài đặt của nó và thêm một mô hình sử dụng nhà cung cấp OpenAI với URL cơ sở API tùy chỉnh. Continue đã thay đổi định dạng cấu hình của mình theo thời gian, từ tệp JSON sang tệp YAML, vì vậy hãy kiểm tra tài liệu hiện tại của tiện ích nếu tệp của bạn trông khác. Các trường có cùng ý nghĩa trong cả hai định dạng. Ở dạng JSON, một mục mô hình trông như thế này:

Copy{
  "models": [
    {
      "title": "Uncensored API",
      "provider": "openai",
      "model": "uncensored",
      "apiBase": "https://api.deepseekapikey.com/v1",
      "apiKey": "YOUR_KEY"
    }
  ]
}

Ở dạng YAML, mục mô hình có cùng các khóa: một tên, provider: openai, model: uncensored, apiBase được đặt thành URL cơ sở và khóa. Lưu tệp, chọn mô hình mới trong menu thả xuống của Continue và đặt câu hỏi trong bảng bên.

Lưu ý rằng API này chỉ tài liệu hóa chat completions. Trò chuyện, chỉnh sửa và giải thích là các tính năng phù hợp nhất. Tính năng tự động hoàn thành inline bằng Tab thường dựa trên một kiểu yêu cầu khác dùng để hoàn thành văn bản ở giữa dòng, không được liệt kê trong các tính năng của API này, vì vậy đừng mong đợi nó hoạt động. Hãy giữ một nhà cung cấp tự động hoàn thành riêng biệt cho việc đó nếu bạn cần.

Khóa nằm trong một tệp, vì vậy hãy giữ tệp đó khỏi kho lưu trữ của bạn. Nếu bạn sử dụng cấu hình cấp không gian làm việc, hãy thêm nó vào .gitignore, hoặc sử dụng cấu hình toàn cầu trong thư mục home của bạn.

Tùy chọn 2: Cline và các tiện ích agent tương tự

Cline và các tiện ích kế thừa từ nó như Roo Code chạy một agent đọc tệp, đề xuất chỉnh sửa và chạy lệnh với sự chấp thuận của bạn. Bảng cài đặt của chúng có menu thả xuống nhà cung cấp API. Chọn mục cho nhà cung cấp tương thích OpenAI và điền vào biểu mẫu:

1. URL cơ sở: https://api.deepseekapikey.com/v1
2. Khóa API: khóa của bạn
3. ID mô hình: uncensored

Một số phiên bản yêu cầu kích thước cửa sổ ngữ cảnh và giá trị đầu ra tối đa cho mô hình tùy chỉnh. Nhập 100000 cho cửa sổ, vì đó là kích thước ngữ cảnh của API này, gồm prompt và phản hồi cộng lại. Chọn giá trị đầu ra tối đa là vài nghìn token để một phản hồi không thể chạy dài vô tận.

Agent sử dụng gọi hàm hoặc định dạng văn bản có cấu trúc để hành động, và API hỗ trợ hình thức gọi hàm OpenAI (tools, tool_choice, kết quả role: "tool") cùng với truyền phát. Mức độ mô hình tuân thủ hướng dẫn của agent khác nhau tùy mô hình, vì vậy hãy bắt đầu với các tác vụ nhỏ, chẳng hạn như đổi tên một hàm trên hai tệp và quan sát vài bước đầu tiên trước khi để nó chạy lâu hơn.

Agent cũng gửi nhiều yêu cầu liên tiếp. Khóa đầy đủ cho phép 8 yêu cầu đồng thời và 300 mỗi phút, khóa dùng thử cho phép 2 và 60. Một agent đơn lẻ thường nằm trong những con số đó, nhưng hai agent cộng với bảng trò chuyện trên khóa dùng thử có thể đạt giới hạn đồng thời và tạo ra lỗi 429.

Gọi API từ mã của riêng bạn trong VS Code

Đôi khi mục tiêu không phải là một tiện ích mà là một tập lệnh bạn chạy từ trình soạn thảo. Bất kỳ SDK OpenAI nào cũng hoạt động. Trong Node:

Copyimport OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.deepseekapikey.com/v1",
  apiKey: process.env.API_KEY,
});

const res = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Review this function for off-by-one errors." }],
});
console.log(res.choices[0].message.content);

Giữ khóa trong biến môi trường, tệp .env được git bỏ qua hoặc kho lưu trữ bí mật của hệ điều hành, không bao giờ trong một tệp đã commit. Phiên bản Python của cùng một lệnh gọi sử dụng OpenAI(base_url="https://api.deepseekapikey.com/v1", api_key=...). bắt đầu nhanh có nhiều ví dụ hơn, bao gồm truyền phát và chế độ JSON.

Chi phí cho các phiên lập trình

Giá là $0,15 cho mỗi 1 triệu token đầu vào và $0,50 cho mỗi 1 triệu token đầu ra. Các trợ lý lập trình gửi rất nhiều ngữ cảnh, vì vậy đầu vào chiếm ưu thế. Hãy xem xét một yêu cầu với 30.000 token mã và lịch sử trò chuyện cùng câu trả lời 1.000 token:

• Đầu vào: 30.000 / 1.000.000 x $0,15 = $0,0045
• Đầu ra: 1.000 / 1.000.000 x $0,50 = $0,0005
• Tổng cộng: $0,005 cho mỗi yêu cầu, vì vậy 200 yêu cầu tốn $1,00.

Một prompt đầy đủ 100.000 token với cùng câu trả lời tốn $0,015 + $0,0005 = $0,0155. Điều đó vẫn nhỏ, nhưng các vòng lặp agent lặp lại nhiều lần, vì vậy hãy giữ ngữ cảnh chặt chẽ: mở các tệp cần thiết, không phải toàn bộ kho lưu trữ, và bắt đầu một cuộc trò chuyện mới khi nhiệm vụ thay đổi.

Tín dụng là trả trước và không bao giờ hết hạn, và không có gói đăng ký. Các yêu cầu thất bại hoặc bị từ chối không bị tính phí. Nạp tiền với bất kỳ số nguyên nào từ $20 đến $500, với +5% từ $50, +10% từ $100 và +15% từ $200, thanh toán bằng tiền mã hóa (USDT trên TRC20, USDC trên Base). Nạp $50 sẽ được ghi có $52,50. Xem trang giá cả để biết chi tiết.

Danh sách kiểm tra khắc phục sự cố

• 401 Không ủy quyền. Khóa không đúng hoặc có khoảng trắng thừa. Hãy nhớ rằng khóa do nền tảng của riêng DeepSeek cấp sẽ không hoạt động ở đây.
• 404 Không tìm thấy. Kiểm tra URL cơ sở. Một số tiện ích tự thêm /chat/completions, vì vậy hãy cung cấp cho chúng URL cơ sở kết thúc bằng /v1. Những tiện ích khác muốn đường dẫn đầy đủ. Hãy làm theo gợi ý trong trường.
• Không tìm thấy mô hình. ID mô hình phải chính xác là uncensored.
• 429 với mã concurrency. Quá nhiều yêu cầu cùng một lúc. Đóng các cuộc trò chuyện hoặc agent bổ sung. Các yêu cầu truyền phát giữ vị trí của chúng cho đến khi hoàn tất.
• 429 với Retry-After: 5. Quá tải tạm thời. Chờ năm giây và tiện ích thử lại thường sẽ thành công.
• Yêu cầu quá lớn. Giới hạn body request là 8 MB và giới hạn ngữ cảnh là 100.000 token. Cắt giảm các tệp đính kèm.

Prompt không được sử dụng để huấn luyện, nhưng tiện ích của bạn có thể giữ nhật ký và dữ liệu telemetry riêng, vì vậy hãy kiểm tra cài đặt của nó nếu bạn làm việc với mã riêng. Dịch vụ dành cho mục đích người lớn hợp pháp và có quy tắc cứng về nội dung tình dục liên quan đến người chưa thành niên. Nó chỉ tạo văn bản, vì vậy mã thì ổn và hình ảnh thì không. Nếu bạn muốn tìm hiểu thêm về cách dịch vụ này khác với DeepSeek của riêng họ, bài viết về những hiểu lầm và sự thật sẽ đề cập đến điều đó.

Hướng dẫn khác

• Khóa API DeepSeek trong Janitor AI: Hướng dẫn thiết lập với API của chúng tôi
• Khóa API DeepSeek trong SillyTavern: Kết nối API của chúng tôi
• API DeepSeek: Những điều chưa biết vs. Sự thật về truy cập không kiểm duyệt