Tài liệu API Hop
Mô hình DeepSeek
>-
https://api.apihop.ai/v1/chat-completionsMô hình DeepSeek dùng điểm cuối Hoàn thành hội thoại chung. Để chuyển mô hình, chỉ đổi giá trị model; điểm cuối và xác thực giữ nguyên.
POST https://api.apihop.ai/v1/chat-completionsMô hình khả dụng
Giá trị model | Định vị | Không truyền luồng | Truyền luồng SSE |
|---|---|---|---|
deepseek-v4-flash | Cấp Flash và điểm khởi đầu thực tế cho hội thoại thường ngày hoặc đánh giá theo lô | Có | Có |
deepseek-v4-pro | Cấp Pro cho đánh giá ưu tiên suy luận phức tạp và chất lượng đầu ra | Có | Có |
deepseek-v4.1-flash | DeepSeek V4.1 Flash; ID mô hình riêng, không phải bí danh V4 Flash | Sau khi triển khai và bật | Sau khi triển khai và bật |
V4.1 Flash chỉ khả dụng sau khi cấu hình định tuyến được triển khai và bật. Chỉ dùng khi GET https://api.apihop.ai/v1/models trả deepseek-v4.1-flash cho khóa API của bạn. Mục tham chiếu này không xác nhận đã triển khai sản xuất hoặc kiểm thử suy luận thành công. ID V4 Flash và V4 Pro hiện có giữ nguyên.
Định vị này giúp chọn mô hình ban đầu để thử; đây không phải SLA độ trễ, thông lượng hay chất lượng. So sánh mô hình khả dụng bằng prompt, độ dài đầu ra và mức đồng thời của chính bạn trước khi dùng trong sản xuất.
Xác thực
Authorization: Bearer YOUR_API_KEY
Content-Type: application/jsonYêu cầu không truyền luồng
Điểm cuối mặc định trả một phản hồi Chat Completions hoàn chỉnh. Ví dụ đặt rõ stream: false để hành vi vẫn rõ ràng khi sao chép.
{
"model": "deepseek-v4-flash",
"messages": [
{
"role": "system",
"content": "You are a precise technical assistant."
},
{
"role": "user",
"content": "Explain three benefits of event-driven architecture."
}
],
"stream": false
}Để dùng mô hình Pro, chỉ đổi trường mô hình:
{
"model": "deepseek-v4-pro"
}Yêu cầu truyền luồng
Đặt rõ stream: true để truyền luồng và xử lý phản hồi dưới dạng sự kiện SSE cho đến [DONE].
{
"model": "deepseek-v4-pro",
"messages": [
{
"role": "user",
"content": "Create a checklist for a reversible database migration."
}
],
"stream": true
}Trường yêu cầu
modelstringbắt buộcDùng deepseek-v4-flash, deepseek-v4-pro hoặc deepseek-v4.1-flash theo kết quả GET https://api.apihop.ai/v1/models.
messagesobject[]bắt buộcTin nhắn kiểu OpenAI Chat Completions. Mỗi tin nhắn chứa role và content.
streambooleanMặc định: falsetrue trả SSE; false trả một phản hồi JSON hoàn chỉnh.
max_tokensintegerSố token đầu ra tối đa tùy chọn, là số nguyên dương. Bỏ trường này để dùng mặc định thượng nguồn cho mô hình được chọn. Tùy mô hình, ngân sách có thể gồm token suy luận và văn bản cuối cùng. Ngân sách nhỏ có thể cắt câu trả lời hoặc cạn trước văn bản cuối cùng; tăng ngân sách có thể tăng chi phí.
max_completion_tokensintegerLựa chọn tương thích tùy chọn thay cho max_tokens, với cùng lưu ý ngân sách. Mô hình được chọn quyết định hỗ trợ; bỏ cả hai trường để dùng mặc định thượng nguồn.
Xem Hoàn thành hội thoại chung để biết các trường dùng chung như temperature, top_p, frequency_penalty, presence_penalty, stop và n. Hỗ trợ và tác dụng ngữ nghĩa có thể khác theo mô hình; hướng dẫn này không xác nhận V4.1 Flash hỗ trợ mọi trường tùy chọn.
Phản hồi thành công
{
"id": "chatcmpl_...",
"object": "chat.completion",
"created": 1787200000,
"model": "deepseek-v4-flash",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "1. Services can remain loosely coupled..."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 31,
"completion_tokens": 96,
"total_tokens": 127
}
}Phản hồi có thể chứa thêm chi tiết sử dụng; coi chúng là tùy chọn.
Lưu ý sử dụng
- Hợp đồng công khai hiện tại là Chat Completions, gồm không truyền luồng và truyền luồng SSE.
- Các mô hình này hiện không khả dụng qua OpenAI Responses hoặc Claude Messages.
- Đặt trường
modeltrong thân yêu cầu thành ID chính xác:deepseek-v4-flash,deepseek-v4-prohoặcdeepseek-v4.1-flash. - Chỉ dùng ID mô hình do
GET https://api.apihop.ai/v1/modelstrả về. - Dùng
GET https://api.apihop.ai/v1/modelsđể biết mô hình hiển thị với khóa API hiện tại, và dùng bảng điều khiển để xem giá hiện hành.