VI ▾
Lấy khóa API

deepseek4api.comHướng dẫn

AI không kiểm duyệt trong VS Code: Continue, Cline và Cursor

Cài đặt API deepseek v4 trong VS Code chỉ gồm ba giá trị: base URL, khóa API và model ID. Hướng dẫn này chỉ rõ chính xác nơi dán chúng trong Continue, Cline và Cursor, cách kiểm tra kết nối trước, và những gì cần làm khi nó thất bại.

Cập nhật

Minh họa đẳng cự của một bảng chỉnh sửa mã được kết nối bằng cáp với một nút đám mây phát sáng, đại diện cho một endpoint API

Điểm chính

  • Bất kỳ tiện ích mở rộng trình soạn thảo nào có nhà cung cấp tương thích OpenAI tùy chỉnh đều hoạt động: hãy sử dụng base URL https://api.deepseek4api.com/v1 và model ID uncensored.
  • Hãy kiểm tra bằng curl trên GET /v1/models trước khi chạm vào trình soạn thảo, để bạn biết khóa và URL là đúng.
  • API chỉ hỗ trợ chat completions, nên dùng nó cho hội thoại, chỉnh sửa và agent, không dùng cho tự động hoàn thành bằng Tab nội tuyến.
  • Một câu hỏi lập trình điển hình với 8.000 token ngữ cảnh tốn khoảng $0,0017.

Những gì bạn cần trước khi bắt đầu

Các trình soạn thảo cho phép bạn đưa mô hình của riêng mình vào đều yêu cầu cùng ba thứ. Dưới đây là các yêu cầu đó cho dịch vụ này.

Cài đặtGiá trị
Base URLhttps://api.deepseek4api.com/v1
Khóa APIKhóa của bạn từ trang khóa API, được gửi dưới dạng Authorization: Bearer
ID mô hìnhuncensored
Loại nhà cung cấp"OpenAI" hoặc "tương thích OpenAI"

Một lời giải thích nhanh để không có gì bất ngờ sau này. Tên của trang web này đề cập đến DeepSeek V4, nhưng mô hình đằng sau endpoint là một mô hình trọng số mở do một nhà cung cấp độc lập vận hành. Nó không phải là API chính thức của DeepSeek. Trong trình soạn thảo, bạn chọn nhà cung cấp chung chung tương thích OpenAI, không bao giờ là nhà cung cấp cụ thể của nhà cung cấp, vì nhà cung cấp cụ thể sẽ trỏ đến máy chủ của nhà cung cấp đó và bỏ qua base URL của bạn.

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 sau khi đăng ký, không cần thẻ, điều này là đủ cho các bài kiểm tra bên dưới. Khóa dùng thử chạy ở mức 2 yêu cầu đồng thời và 60 yêu cầu mỗi phút.

Kiểm tra endpoint từ terminal trước

Một nửa số vấn đề thiết lập trình soạn thảo là do URL sai hoặc khóa bị gõ nhầm, và các trình soạn thảo rất kém trong việc cho bạn biết cái nào. Hai lệnh curl loại bỏ sự do dự. Mở terminal trong VS Code (Ctrl+` trên Windows và Linux, Cmd+` trên macOS) và chạy lệnh đầu tiên.

# expect the model id "uncensored" in the list
curl https://api.deepseek4api.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Bạn sẽ thấy một danh sách JSON bao gồm mô hình uncensored. Bây giờ hãy gửi một yêu cầu chat thực:

curl https://api.deepseek4api.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a Python function that reverses a linked list."}],
    "max_tokens": 300
  }'

Nếu cả hai đều hoạt động, trình soạn thảo sẽ hoạt động với cùng các giá trị. Nếu cái đầu tiên trả về lỗi xác thực, khóa sai hoặc có khoảng trắng thừa. Nếu bạn nhận được 404, hãy kiểm tra xem URL có kết thúc bằng /v1 và không có đường dẫn thừa nào sau đó không.

Continue trong VS Code

Continue là một tiện ích mở rộng trợ lý mã nguồn mở cho VS Code và JetBrains. Cài đặt nó từ chế độ xem Tiện ích mở rộng, mở bảng của nó và mở tệp cấu hình từ biểu tượng bánh răng. Trong các phiên bản hiện tại, tệp là config.yaml, và một mục mô hình cho API này trông như thế này:

models:
  - name: Uncensored API
    provider: openai
    model: uncensored
    apiBase: https://api.deepseek4api.com/v1
    apiKey: YOUR_API_KEY
    roles:
      - chat
      - edit
      - apply
    defaultCompletionOptions:
      contextLength: 100000
      maxTokens: 2000
      temperature: 0.4

Các bản phát hành Continue cũ hơn dùng config.json với mảng models thay thế, trong đó các trường cùng xuất hiện dưới dạng "provider": "openai", "model": "uncensored" và "apiBase": "https://api.deepseek4api.com/v1". Định dạng tệp đã thay đổi giữa các phiên bản, nên nếu bảng điều khiển của bạn hiển thị bố cục khác, hãy làm theo cấu trúc mà Continue tạo cho bạn và thay thế bằng ba giá trị này.

Độ dài ngữ cảnh 100000 khớp với cửa sổ của API này (prompt cộng với completion). Giá trị maxTokens thấp hơn là giới hạn cho mỗi câu trả lời. Nó bảo vệ bạn khỏi một câu trả lời dài mà bạn không cần. Hãy lưu tệp, chọn mô hình trong menu thả xuống chat Continue và hỏi một câu hỏi về tệp bạn đang mở. Đánh dấu mã và sử dụng lệnh chỉnh sửa để viết lại một phần được chọn.

Cline

Cline là một tiện ích mở rộng kiểu agent đọc tệp, đề xuất chỉnh sửa và chạy lệnh với sự phê duyệt của bạn. Mở cài đặt của nó, chọn nhà cung cấp API có tên "OpenAI Compatible" và điền vào các trường:

  1. Base URL: https://api.deepseek4api.com/v1
  2. API Key: khóa của bạn
  3. ID mô hình: uncensored

Agent rất hay trò chuyện. Một nhiệm vụ đơn lẻ có thể kích hoạt hàng tá yêu cầu khi công cụ đọc tệp, chỉnh sửa chúng và kiểm tra kết quả, và mỗi yêu cầu gửi lại toàn bộ hội thoại cho đến nay. Đây là nơi tính toán chi phí quan trọng. Giả sử một bước agent mang 40.000 token ngữ cảnh và viết 1.500 token. Chi phí là 40.000 x $0,15 / 1M cộng 1.500 x $0,50 / 1M, tức là $0,006 cộng $0,00075, hay $0,00675. Hai mươi bước như vậy cho một nhiệm vụ tốn $0,135. Hãy bắt đầu các nhiệm vụ mới thay vì để một hội thoại kéo dài hàng giờ, và hóa đơn của bạn sẽ giữ nguyên.

API hỗ trợ gọi công cụ (tools, tool_choice và tool_calls dạng stream, với kết quả trả về dưới dạng role: "tool"), điều mà các tiện ích mở rộng agent dựa vào. Hãy kiểm tra tài liệu để biết chính xác hình dạng yêu cầu nếu bạn xây dựng agent của riêng mình.

Cursor và các trình soạn thảo khác

Cursor là một trình soạn thảo riêng biệt được xây dựng trên nền mã của VS Code. Nó có một trang cài đặt mô hình nơi bạn có thể nhập khóa OpenAI của riêng mình và ghi đè base URL của OpenAI. Dán https://api.deepseek4api.com/v1 vào đó, dán khóa của bạn, và thêm một mô hình tùy chỉnh tên là uncensored. Các tùy chọn và quy tắc gói của Cursor thay đổi theo thời gian, vì vậy hãy kiểm tra tài liệu hiện tại của nó để biết nơi đặt phần ghi đè và tính năng nào sử dụng nó. Các tính năng chạy trên các mô hình riêng của Cursor, chẳng hạn như tự động hoàn thành bằng Tab, không đi qua endpoint của bạn.

Cùng một cách tiếp cận hoạt động trong bất kỳ công cụ nào cung cấp nhà cung cấp tương thích OpenAI tùy chỉnh: Zed, plugin JetBrains, plugin Neovim, trợ lý terminal và các tập lệnh của riêng bạn. Nếu một công cụ chỉ chấp nhận một danh sách nhà cung cấp cố định, hãy tìm biến môi trường. Nhiều công cụ dựa trên OpenAI đọc OPENAI_BASE_URL và OPENAI_API_KEY, mà bạn có thể đặt trong shell của mình:

# base URL https://api.deepseek4api.com/v1, model uncensored
export OPENAI_BASE_URL="https://api.deepseek4api.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"
# then select the model name "uncensored" inside the tool

Những gì hoạt động tốt và những gì không

Dưới đây là mức độ phù hợp của API này với quy trình làm việc lập trình.

  • Hoạt động: chat về mã của bạn, giải thích lỗi, viết hàm, tái cấu trúc một phần được chọn, tạo bài kiểm tra, soạn thông báo commit, các công cụ agent gọi hàm.
  • Không hoạt động: hoàn thành nội tuyến dựa vào endpoint fill-in-the-middle. API chỉ cung cấp POST /v1/chat/completions và GET /v1/models, nên không có tuyến hoàn thành cũ. Hãy giữ một công cụ khác cho tự động hoàn thành bằng Tab nếu bạn dựa vào nó.
  • Không cung cấp: embeddings, vì vậy các tiện ích mở rộng lập chỉ mục cơ sở mã của bạn bằng mô hình embedding cần một nguồn embedding riêng. Điều tương tự cũng áp dụng cho tạo hình ảnh, âm thanh và video, cũng như fine-tuning.

Mô hình là một mô hình văn bản mục đích chung không từ chối việc sử dụng người lớn hợp pháp. Chúng tôi không đưa ra tuyên bố benchmark về lập trình, vì vậy hãy đánh giá nó trên mã của riêng bạn. Hãy sử dụng nhiệt độ thấp cho mã, khoảng 0,2 đến 0,4 và đưa cho tiện ích mở rộng một hướng dẫn rõ ràng về ngôn ngữ và phong cách.

Về chi phí, một câu hỏi lập trình gửi 8.000 token ngữ cảnh tệp và nhận câu trả lời 1.000 token tốn 8.000 x $0,15 / 1M cộng 1.000 x $0,50 / 1M, tức là $0,0012 cộng $0,0005, hoặc $0,0017. Một trăm cái như vậy mỗi ngày làm việc trong 22 ngày là 2.200 lệnh gọi và $3,74. Xem trang giá cả để biết các cấp độ nạp tiền.

Khắc phục các lỗi phổ biến

Triệu chứngNguyên nhân có thểCách khắc phục
Lỗi 401 hoặc lỗi xác thựcSai khóa, khoảng trắng thừa, hoặc khóa được dán vào trường saiSao chép lại khóa, sau đó lặp lại bài kiểm tra curl
404 không tìm thấyBase URL thiếu /v1 hoặc có thêm đường dẫn ở cuốiSử dụng chính xác https://api.deepseek4api.com/v1
Không tìm thấy mô hìnhTên mô hình được gõ khác nhauSử dụng uncensored viết thường
429 với concurrencyNhiều yêu cầu cùng lúc hơn so với khóa của bạn cho phép (8 với khóa thường, 2 với khóa dùng thử)Giảm các yêu cầu đồng thời của tiện ích mở rộng, hoặc đợi
429 với rate_limitedQuá 300 yêu cầu mỗi phút (60 với khóa dùng thử)Làm chậm các bước của agent hoặc batch
429 với Retry-After: 5Quá tải tạm thờiHãy thử lại sau năm giây
Yêu cầu quá lớnBody vượt quá 8 MBGửi ít file hơn hoặc các file nhỏ hơn làm context

Các phản hồi được stream giữ một slot đồng thời cho đến khi stream kết thúc, nên nếu bạn mở nhiều cửa sổ hội thoại cùng lúc với khóa dùng thử, bạn sẽ chạm giới hạn đồng thời nhanh hơn bạn nghĩ. Hãy kiểm tra các tiêu đề phản hồi X-RateLimit-Limit-Requests và X-RateLimit-Limit-Concurrency để xác nhận khóa của bạn cho phép gì, và tiêu đề X-Balance-USD để xem còn lại bao nhiêu tín dụng. Các yêu cầu thất bại không bị tính phí, nên các lần thử lại là miễn phí.

Hỏi đáp

Tôi phải nhập model ID nào trong VS Code?

Nhập uncensored, viết thường, với base URL https://api.deepseek4api.com/v1 và khóa API của bạn. Chọn loại nhà cung cấp tương thích OpenAI trong tiện ích mở rộng.

Đây có phải là API DeepSeek V4 chính thức không?

Không. Đây là một mô hình trọng số mở do một nhà cung cấp độc lập vận hành, và nó không phải là API chính thức của DeepSeek hay bất kỳ nhà cung cấp nào khác.

Tôi có thể dùng nó cho tính năng tự động hoàn thành mã nội tuyến không?

Không dùng được cho tính năng hoàn thành fill-in-the-middle. API chỉ cung cấp chat completions và danh sách mô hình. Nó hoạt động cho chat, chỉnh sửa và các công cụ agent.

Tại sao tôi nhận lỗi 429 trong tiện ích mở rộng agent?

Các agent gửi nhiều yêu cầu cùng lúc. Khóa thường cho phép 8 yêu cầu đồng thời và 300 yêu cầu mỗi phút, trong khi khóa dùng thử cho phép 2 và 60. Hãy giảm độ đồng thời hoặc thử lại sau độ trễ Retry-After.

Khóa của bạn chỉ cách một biểu mẫu

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