VI ▾
Lấy khóa API

deepseek4api.comHướng dẫn

Hướng dẫn tài liệu API DeepSeek và giải pháp thay thế tương thích

Hầu hết mọi người khi mở tài liệu API deepseek đều muốn có năm câu trả lời giống nhau: base URL, cách xác thực, tên mô hình nào để sử dụng, tham số nào hoạt động và một lệnh gọi hoạt động trông như thế nào. Trang này bao gồm những điều đó, sau đó hiển thị các lệnh gọi tương tự đối với một endpoint thay thế tương thích OpenAI mà bạn có thể thay thế.

Cập nhật

Hai đầu nối khớp nối với nhau bởi các khối mã phát sáng, cho thấy việc thay thế API dễ dàng
Hai chồng tiền xu cao khác nhau đổ vào một máy chủ nhỏ, minh họa giá token đầu vào và đầu ra

Điểm chính

  • Tài liệu DeepSeek mô tả một API kiểu OpenAI, vì vậy SDK OpenAI hoạt động bằng cách thay đổi base URL, khóa và tên mô hình.
  • Trang web này không phải là API chính thức của DeepSeek; nó phục vụ một mô hình trọng số mở độc lập duy nhất dưới ID uncensored.
  • Cùng một mã chạy trên cả hai: chỉ ba giá trị thay đổi.
  • Cửa sổ ngữ cảnh tại đây là 100.000 token, hỗ trợ truyền phát (streaming), gọi hàm và chế độ JSON.

Năm điều tài liệu API DeepSeek trả lời

Khi các nhà phát triển tìm kiếm tài liệu API deepseek, họ thường đang cố gắng hoàn thành một yêu cầu đầu tiên. Mẫu này giống với bất kỳ dịch vụ kiểu OpenAI nào, đó là lý do tại sao một bảng giúp dễ dàng so sánh.

Câu hỏiTài liệu DeepSeekAPI này
URL gốcĐược tài liệu hóa trong hướng dẫn nhanh của họ (api.deepseek.com)https://api.deepseek4api.com/v1
Xác thựcBearer token trong tiêu đề AuthorizationBearer token trong tiêu đề Authorization
Tên mô hìnhĐược liệt kê trong tài liệu mô hình của họ; hãy kiểm tra các tên hiện tạiuncensored
Endpoint chínhChat completionsHoàn tất trò chuyện, Phản hồi, danh sách mô hình
Bảng giáKiểm tra giá hiện tại của họ$0,15 / 1M token đầu vào, $0,50 / 1M token đầu ra

Đọc các trang chính thức của DeepSeek để biết bất kỳ thông tin nào về mô hình, giá và giới hạn của họ; chúng thay đổi và bài viết này không cố gắng diễn giải lại chúng. Điểm mấu chốt là hình thức yêu cầu được chia sẻ, vì vậy việc chuyển đổi giữa hai bên chỉ là thay đổi cấu hình.

Một điều cần rõ ràng: trang web này không phải là API chính thức của DeepSeek, và nó không phải là bộ chuyển hướng đến DeepSeek. Đây là một endpoint được lưu trữ, tương thích OpenAI, phục vụ một mô hình trọng số mở do một nhà cung cấp độc lập vận hành và được tinh chỉnh để trả lời mà không có từ chối nội dung cho việc sử dụng người trưởng thành hợp pháp.

Bước 1: xác thực và base URL

Tạo tài khoản (Google, hoặc email và mật khẩu) và mở trang khóa API. Sao chép khóa. Người dùng mới cũng 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 và không cần thẻ.

Mọi yêu cầu đều mang tiêu đề Authorization: Bearer YOUR_KEY. Với curl:

curl https://api.deepseek4api.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

Điều này liệt kê mô hình có sẵn, uncensored. Nếu bạn sao chép một ví dụ DeepSeek, hãy thay đổi ba thứ: base URL, khóa và tên mô hình. Không cần thay đổi gì khác.

Bước 2: một lệnh gọi chat completion bằng Python

SDK OpenAI là thứ mà tài liệu DeepSeek sử dụng trong các ví dụ của họ, và nó hoạt động không thay đổi tại đây:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.deepseek4api.com/v1",
    api_key="YOUR_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a concise technical assistant."},
        {"role": "user", "content": "Explain idempotency in two sentences."},
    ],
    temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)

Các tham số lấy mẫu được hỗ trợ, bao gồm temperature, top_p, stop, seed và các hình phạt về sự hiện diện và tần suất, được chuyển tiếp. max_tokens là tùy chọn vì phần hoàn thành có thể sử dụng bất kỳ phần còn lại nào của cửa sổ 100.000 token.

Bước 3: truyền phát, chế độ JSON và công cụ

Truyền phát

Đặt stream: true để nhận các sự kiện do máy chủ gửi. Việc sử dụng được báo cáo ở cuối luồng.

import OpenAI from "openai";

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

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a haiku about caching." }],
  stream: true,
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

Chế độ JSON

Gửi response_format: {"type": "json_object"} và đề cập đến JSON trong prompt của bạn. Đầu ra là một đối tượng JSON mà bạn có thể phân tích trực tiếp.

Gọi hàm

Các tham số tools và tool_choice hoạt động theo định dạng OpenAI, các lệnh gọi công cụ được truyền lại dưới dạng các phần nhỏ, và bạn trả về kết quả dưới dạng các thông điệp với role: "tool". Nếu mã của bạn đã thực hiện gọi hàm đối với DeepSeek, nó nên được chuyển đổi với sự thay đổi ba giá trị ở trên, nhưng hãy kiểm tra các lược đồ của riêng bạn.

Nơi hai bên khác nhau

Cùng giao thức không có nghĩa là cùng dịch vụ. Những điều cần kiểm tra khi bạn di chuyển khối lượng công việc:

  • Hành vi mô hình. Một mô hình khác sẽ đưa ra câu trả lời, phong cách suy luận và hành vi từ chối khác nhau. Chạy lại bộ prompt của bạn trước khi chuyển đổi bất cứ thứ gì trong môi trường sản xuất.
  • Các trường cụ thể cho suy luận. Nếu bạn phụ thuộc vào các trường phản hồi cụ thể của nhà cung cấp từ một mô hình DeepSeek cụ thể, đừng giả định rằng chúng tồn tại tại đây. Các trường chat completion tiêu chuẩn thì có.
  • Các tính năng không được cung cấp. API này chỉ dành cho văn bản: không có hình ảnh, âm thanh, video, embedding hoặc fine-tuning.
  • Giới hạn. 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. Vượt quá giới hạn, bạn sẽ nhận được HTTP 429 với rate_limited hoặc concurrency.
  • Số dư. Kiểm tra tín dụng bằng GET /v1/balance, cách cấp tín dụng kiểu OpenAI, hoặc tiêu đề X-Balance-USD trên mỗi phản hồi.

Để xem xét cách một người dùng tập trung vào DeepSeek suy nghĩ về chi phí, hãy xem ghi chú giá DeepSeek; đối với các thiết lập trình soạn thảo, hãy xem hướng dẫn VS Code.

Chi phí cho một lệnh gọi tại đây

Thanh toán là tín dụng trả trước và tính theo token: $0,15 cho mỗi 1M token đầu vào và $0,50 cho mỗi 1M token đầu ra. Một yêu cầu với 1.500 token đầu vào và 600 token đầu ra tốn 1.500 x $0,15 / 1M = $0,000225 cho đầu vào cộng 600 x $0,50 / 1M = $0,0003 cho đầu ra, tổng cộng $0,000525. Khoản nạp tiền $20 bao phủ khoảng 38.000 yêu cầu như vậy.

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

Danh sách kiểm tra di chuyển

Nếu bạn đang chuyển đổi một ứng dụng đã giao tiếp với DeepSeek, hãy thực hiện theo các bước sau theo thứ tự. Mỗi bước mất vài phút.

  1. Đặt ba giá trị trong cấu hình. Base URL, khóa và tên mô hình nên đến từ các biến môi trường, không phải các hằng số rải rác trong mã.
  2. Chạy kiểm tra khói. Một lệnh gọi chat completion, một lệnh gọi truyền phát, một lệnh gọi chế độ JSON và một lệnh gọi công cụ. Bốn đoạn mã ở trên bao gồm chúng.
  3. Phát lại các prompt thực. Lấy 30 prompt từ nhật ký của bạn và so sánh câu trả lời cạnh nhau. Đánh giá chúng dựa trên các tiêu chí của riêng bạn thay vì điểm số chung chung.
  4. Xử lý 429. Thêm thử lại với độ trễ tăng dần và tôn trọng Retry-After. Một yêu cầu truyền phát giữ slot độ đồng thời của nó cho đến khi luồng kết thúc, vì vậy hãy đóng các luồng bị bỏ rơi.
  5. Theo dõi chi phí. Ghi lại usage từ mỗi phản hồi và so sánh nó với tiêu đề X-Balance-USD trong một ngày lưu lượng truy cập.
  6. Triển khai dần dần. Gửi 5 đến 10 phần trăm lưu lượng truy cập đến endpoint mới trước, sau đó tăng dần.

So sánh chi phí trên mỗi tác vụ, không phải giá trên mỗi token, vì các mô hình khác nhau sử dụng số lượng token khác nhau cho cùng một công việc. Để kiểm tra tính linh hoạt của các mô hình viết văn bản, bài viết roleplay là một công cụ bổ trợ hữu ích.

Lựa chọn giữa các tùy chọn

Sử dụng API chính chủ của DeepSeek khi bạn đặc biệt cần mô hình DeepSeek, các tính năng nhà cung cấp của nó hoặc hỗ trợ chính thức. Sử dụng endpoint này khi bạn muốn một mô hình tương thích OpenAI được lưu trữ, trả lời mà không từ chối nội dung cho mục đích người trưởng thành hợp pháp, với việc thanh toán tín dụng trả trước đơn giản và prompt không được sử dụng để huấn luyện. Nhiều nhóm sẽ muốn cả hai đằng sau một công tắc cấu hình, điều mà giao thức chia sẻ này giúp dễ dàng. Tài liệu tham khảo cho API này có trong tài liệu.

Hỏi đáp

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

Không. Đây là một endpoint độc lập tương thích OpenAI, phục vụ một mô hình trọng số mở duy nhất với ID uncensored. Đây không phải dịch vụ của DeepSeek và không chuyển hướng đến nó.

Tôi có thể tái sử dụng mã DeepSeek của mình không?

Nếu nó sử dụng SDK OpenAI hoặc định dạng chat completions, thường là có. Thay đổi base URL, khóa và tên mô hình, sau đó kiểm tra các prompt của bạn.

Tôi tìm tên mô hình ở đâu?

Gọi GET /v1/models. API này phục vụ một mô hình duy nhất với ID uncensored.

Cửa sổ ngữ cảnh dài bao nhiêu?

100.000 token cho prompt và kết quả hoàn thành.

Bearer token trong tiêu đề Authorization

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