getdeepseekapi.comHướng dẫn
URL API DeepSeek và Base URL: Cách chuyển đổi
URL API deepseek bạn sao chép từ tài liệu chính thức của DeepSeek là một base URL, và nó chỉ hoạt động với khóa của DeepSeek và các mô hình của DeepSeek. Nếu bạn muốn một endpoint kiểu OpenAI khác, bạn hãy thay đổi URL đó, khóa và ID mô hình.
Cập nhật
Điểm chính
- Base URL là tiền tố; SDK sẽ thêm /chat/completions vào nó.
- Dịch vụ này sử dụng https://api.getdeepseekapi.com/v1 với ID mô hình là uncensored.
- Đây không phải API của DeepSeek, vì vậy khóa DeepSeek sẽ không hoạt động ở đây và ngược lại.
- Hầu hết các client cũng chấp nhận URL và khóa thông qua OPENAI_BASE_URL và OPENAI_API_KEY.

Base URL, endpoint và đường dẫn: ba phần
Nhiều người thường dán một địa chỉ đầy đủ vào trường yêu cầu tiền tố, rồi nhận lỗi 404. Ba thuật ngữ này giúp bạn phân biệt rõ ràng.
- Base URL: tiền tố chung của mọi lệnh gọi, ví dụ
https://api.getdeepseekapi.com/v1. Đây là giá trị bạn đặt trong cài đặt "API base" hoặc "Base URL" của client. - Đường dẫn endpoint: phần do SDK thêm vào, chẳng hạn như
/chat/completions,/responseshoặc/models. - URL đầy đủ: base cộng với đường dẫn, chẳng hạn như
https://api.getdeepseekapi.com/v1/chat/completions. Các client HTTP thô như curl cần giá trị này.
Quy tắc thường khiến nhiều người mắc lỗi: SDK và ứng dụng yêu cầu base URL, còn curl và node HTTP yêu cầu URL đầy đủ. Nếu công cụ báo lỗi 404, hãy kiểm tra xem bạn đã đặt URL đầy đủ vào nơi yêu cầu base, hay ngược lại. Một đường dẫn bị lặp như /v1/chat/completions/chat/completions trong lỗi chính là manh mối.
URL cơ sở của DeepSeek là gì, và nó không phải là gì
DeepSeek công bố địa chỉ API của riêng mình trong tài liệu, cùng với tên các mô hình mà khóa của họ có thể sử dụng. Hãy xem tại đó để có giá trị hiện tại thay vì tin vào bài viết trên blog, bao gồm bài này. Khóa DeepSeek chỉ hoạt động với endpoint của DeepSeek và không ở đâu khác.
Dịch vụ trên trang web này là một sản phẩm riêng biệt. Nó không phải là API DeepSeek chính thức, không chuyển tiếp đến DeepSeek và không cung cấp các mô hình của DeepSeek. Đây là một API tương thích OpenAI được lưu trữ cho một mô hình trọng số mở duy nhất, 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 từ chối nội dung, phục vụ người dùng trưởng thành hợp pháp. Địa chỉ của nó là:
https://api.getdeepseekapi.com/v1 # model: uncensored
ID mô hình là uncensored, và xác thực là Authorization: Bearer <key>. Khóa được cấp trên trang khóa API. Nếu bạn đang so sánh ý nghĩa của khóa cho từng dịch vụ, trang về khóa API DeepSeek có nhiều chi tiết hơn.
Chuyển đổi endpoint trong các SDK OpenAI
Bất kỳ SDK OpenAI nào cũng hoạt động khi bạn thay đổi base URL và khóa. Trong Python:
from openai import OpenAI
client = OpenAI(
base_url="https://api.getdeepseekapi.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Name three uses for a base URL."}],
)
print(resp.choices[0].message.content)
Trong Node.js, trường này được viết là baseURL:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.getdeepseekapi.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Name three uses for a base URL." }],
});
console.log(resp.choices[0].message.content);
Lưu ý sự khác biệt: Python dùng base_url, Node dùng baseURL. Việc nhầm lẫn sẽ khiến hệ thống ngầm quay lại địa chỉ OpenAI mặc định, sau đó sẽ từ chối khóa của bạn.
Chuyển đổi mà không cần chạm vào mã nguồn
Các SDK OpenAI chính thức đọc hai biến môi trường, vì vậy một ứng dụng hiện có có thể được trỏ lại mà không cần thay đổi mã nguồn:
export OPENAI_BASE_URL="https://api.getdeepseekapi.com/v1"
export OPENAI_API_KEY="YOUR_KEY"
python app.py # the app still has to request model "uncensored"
Tên mô hình là phần bạn không thể bỏ qua. Nếu ứng dụng mã hóa cứng một ID mô hình khác, nó sẽ yêu cầu mô hình đó và thất bại, vì vậy hãy thay đổi nó thành uncensored trong cài đặt hoặc cấu hình của ứng dụng. Nhiều công cụ hiển thị cả ba giá trị này trên một màn hình cài đặt, thường được gắn nhãn API base, API key và model.
Việc hoán đổi ba giá trị tương tự cũng hoạt động trong các framework. Với LangChain trong Python, ví dụ ChatOpenAI(base_url="https://api.getdeepseekapi.com/v1", api_key="YOUR_KEY", model="uncensored") là đủ. Các công cụ lập trình chấp nhận endpoint tương thích OpenAI hoạt động theo cách tương tự; xem hướng dẫn chi tiết về sử dụng API để lập trình.
HTTP thô: các đường dẫn chính xác
Đối với curl, script và node HTTP, bạn tự xây dựng URL đầy đủ. Đây là các đường dẫn trên dịch vụ này:
| Mục đích | Phương thức và URL |
|---|---|
| Chat | POST https://api.getdeepseekapi.com/v1/chat/completions |
| API Responses | POST https://api.getdeepseekapi.com/v1/responses |
| Danh sách mô hình | GET https://api.getdeepseekapi.com/v1/models |
| Số dư | GET https://api.getdeepseekapi.com/v1/balance |
| Số dư, theo phong cách OpenAI | GET https://api.getdeepseekapi.com/v1/dashboard/billing/credit_grants |
curl https://api.getdeepseekapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'
Chỉ sử dụng HTTPS. Truyền phát (streaming) hoạt động với "stream": true qua các sự kiện do máy chủ gửi, và cùng một URL phục vụ cả hai chế độ.
Nhập URL vào các ứng dụng có màn hình cài đặt
Nhiều giao diện chat, trình soạn thảo và công cụ tự động hóa có tùy chọn "endpoint tương thích OpenAI tùy chỉnh". Các nhãn khác nhau, nhưng các trường ánh xạ theo quan hệ một-một:
| Trường trong ứng dụng | Giá trị |
|---|---|
| URL cơ sở, URL cơ sở, endpoint, URL máy chủ | https://api.getdeepseekapi.com/v1 |
| Khóa API, token, bí mật | Khóa của bạn từ dịch vụ này |
| Mô hình, Tên mô hình, ID mô hình | uncensored |
Một số ứng dụng yêu cầu URL chat đầy đủ thay vì URL cơ sở. Trong trường hợp đó, hãy dùng https://api.getdeepseekapi.com/v1/chat/completions. Nếu ứng dụng có nút "kiểm tra kết nối", nó thường gọi danh sách mô hình, là GET /v1/models. Nếu nút thất bại nhưng chat thủ công hoạt động, thì kiểm tra của ứng dụng nghiêm ngặt hơn API, và bạn có thể bỏ qua nó.
Kiểm tra nhanh tính hợp lệ của URL
Trước khi gỡ lỗi ứng dụng, hãy xác minh URL bằng danh sách mô hình. Yêu cầu này không cần body và không tốn phí:
curl -s https://api.getdeepseekapi.com/v1/models -H "Authorization: Bearer $API_KEY" # the chat model ID is uncensored
Bạn sẽ nhận lại JSON với một mảng data. Trang lỗi HTML nghĩa là sai host hoặc đường dẫn, chẳng hạn thiếu subdomain: host bắt đầu bằng api., không phải www..
Sửa các lỗi thường gặp
- 404 Not Found. Base URL thiếu
/v1, có nó hai lần, hoặc bao gồm đường dẫn endpoint. - 401 hoặc lỗi xác thực. Bạn đã dùng khóa từ dịch vụ khác, hoặc header thiếu
Bearer. Các khóa không thể dùng chung giữa các nhà cung cấp. - Không tìm thấy mô hình. Yêu cầu vẫn gọi tên một mô hình từ nhà cung cấp cũ. Hãy đặt
uncensored. - Ứng dụng vẫn giao tiếp với dịch vụ cũ. Một số công cụ lưu trữ cài đặt hoặc đọc một biến khác. Hãy khởi động lại quy trình và kiểm tra màn hình cài đặt.
- Vấn đề dấu gạch chéo cuối. Hầu hết các client đều xử lý được, nhưng nếu một client không hỗ trợ, hãy xóa dấu gạch chéo cuối khỏi base URL.
Nếu bạn không chắc bên nào đang gặp sự cố, hãy gửi lệnh curl ở trên. Phản hồi 200 xác minh URL, khóa và mô hình; mọi lỗi khác đều nằm trong ứng dụng của bạn. tài liệu liệt kê các giới hạn và các header như X-Request-Id, giúp ích khi bạn liên hệ hỗ trợ.
Những gì vẫn giữ nguyên sau khi chuyển đổi
Cấu trúc yêu cầu và phản hồi tuân theo định dạng của OpenAI, vì vậy các mảng message, temperature, top_p, stop, seed, các hình phạt, gọi hàm và chế độ JSON đều hoạt động như bình thường. Cửa sổ ngữ cảnh là 100,000 token cho prompt cộng với kết quả hoàn thành, và kích thước tối đa của thân yêu cầu là 8 MB. Dịch vụ chỉ hỗ trợ văn bản: không hình ảnh, âm thanh, embedding hay fine-tuning, vì vậy các tính năng dựa trên những thứ đó cần một nhà cung cấp khác.
Thanh toán cũng được tách biệt với nhà cung cấp cũ: $0,15 cho mỗi 1M token đầu vào và $0,50 cho mỗi 1M token đầu ra từ tín dụng trả trước, như hiển thị trên trang giá. Người dùng mới có thể nhận $0,50 tín dụng dùng thử miễn phí để kiểm tra xem việc chuyển đổi có hoạt động không trước khi trả bất kỳ khoản phí nào.
Hướng dẫn khác
Hỏi đáp
URL cơ sở của API DeepSeek là gì?
DeepSeek công bố nó trong tài liệu của riêng mình, vì vậy hãy kiểm tra tại đó để biết giá trị hiện tại. Endpoint trên trang web này là một dịch vụ khác tại https://api.getdeepseekapi.com/v1.
Tôi có thể dùng khóa DeepSeek trên endpoint này không?
Không. Khóa được cấp cho từng dịch vụ. Hãy lấy khóa cho API này trên trang khóa, và đặt mô hình thành uncensored.
Base URL có nên kết thúc bằng /v1 không?
Có đối với dịch vụ này: https://api.getdeepseekapi.com/v1. Các SDK thêm đường dẫn endpoint vào sau nó, vì vậy đừng thêm /chat/completions bằng tay.
Tại sao tôi nhận được 404 sau khi thay đổi URL?
Thông thường đường dẫn bị lặp lại hoặc thiếu /v1. Hãy so sánh base URL của bạn với giá trị chính xác ở trên.
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 URL cơ sở. Đó là toàn bộ thiết lập.