# DeepSeek v4 API Tài liệu tham chiếu API đầy đủ cho các mô hình DeepSeek v4 LLM do DeepSeek cung cấp. ## Cập nhật mô hình ### DeepSeek v4 Pro 0813 - Flaq AI đã cập nhật DeepSeek v4 Pro lên bản phát hành chính thức `deepseek-v4-pro-0813` của DeepSeek. - Sử dụng các ID mô hình `0813` dưới đây để truy cập phiên bản chính thức. - Các ID mô hình Pro ban đầu không còn khả dụng. | Biến thể | ID mô hình 0813 | ID mô hình không khả dụng | |---------|---------------|----------------------| | Văn bản sang văn bản | `deepseek-v4-pro-text-to-text-0813` | `deepseek-v4-pro-text-to-text` | | Tìm kiếm web | `deepseek-v4-pro-web-search-0813` | `deepseek-v4-pro-web-search` | ### DeepSeek v4 Flash 0731 - Flaq AI đã cập nhật DeepSeek v4 Flash lên bản phát hành chính thức `deepseek-v4-flash-0731` của DeepSeek. - Sử dụng các ID mô hình `0731` dưới đây để truy cập phiên bản đã cập nhật. - Các ID mô hình Flash ban đầu không còn khả dụng. | Biến thể | ID mô hình 0731 | ID mô hình không khả dụng | |---------|---------------|-------------------| | Văn bản sang văn bản | `deepseek-v4-flash-text-to-text-0731` | `deepseek-v4-flash-text-to-text` | | Tìm kiếm web | `deepseek-v4-flash-web-search-0731` | `deepseek-v4-flash-web-search` | ## Biến thể mô hình API này hỗ trợ bốn biến thể mô hình DeepSeek v4: | Mô hình | Mã định danh | Mô tả | |-------|----|-------------| | **DeepSeek v4 Pro Text to Text** | `deepseek-v4-pro-text-to-text-0813` | Lập luận và viết văn bản chất lượng cao | | **DeepSeek v4 Flash Text to Text** | `deepseek-v4-flash-text-to-text-0731` | Tạo văn bản nhanh hơn, chi phí hợp lý hơn | | **DeepSeek v4 Pro Web Search** | `deepseek-v4-pro-web-search-0813` | Câu trả lời nhận biết web với khả năng lập luận DeepSeek v4 Pro | | **DeepSeek v4 Flash Web Search** | `deepseek-v4-flash-web-search-0731` | Câu trả lời nhận biết web nhanh hơn với DeepSeek v4 Flash | ## So sánh nhanh | Tính năng | Pro Text to Text | Flash Text to Text | Pro Web Search | Flash Web Search | |---------|------------------|------------|----------------|------------------| | Nhập văn bản | Bắt buộc ✅ | Bắt buộc ✅ | Bắt buộc ✅ | Bắt buộc ✅ | | Nhập hình ảnh | Không hỗ trợ ❌ | Không hỗ trợ ❌ | Không hỗ trợ ❌ | Không hỗ trợ ❌ | | Nhập tệp | Không hỗ trợ ❌ | Không hỗ trợ ❌ | Không hỗ trợ ❌ | Không hỗ trợ ❌ | | Tìm kiếm web | Không hỗ trợ ❌ | Không hỗ trợ ❌ | Đã bật ✅ | Đã bật ✅ | | Phản hồi streaming | SSE | SSE | SSE | SSE | | `max_tokens` | Tùy chọn | Tùy chọn | Tùy chọn | Tùy chọn | | `top_p` | Tùy chọn | Tùy chọn | Tùy chọn | Tùy chọn | | `top_k` | Tùy chọn | Tùy chọn | Tùy chọn | Tùy chọn | ## DeepSeek v4 Pro Text to Text ### Điểm cuối ```http POST /api/v1/chat/completions ``` ### Tham số yêu cầu #### Bắt buộc | Tham số | Kiểu | Mô tả | |-----------|------|-------------| | `model` | string | Phải là `"deepseek-v4-pro-text-to-text-0813"` | | `messages` | array | Các tin nhắn chỉ chứa văn bản theo thứ tự. Hỗ trợ vai trò `system`, `user` và `assistant`. Xem LLM API để biết cấu trúc tin nhắn. | | `stream` | boolean | `true` cho SSE, `false` cho một phản hồi JSON duy nhất. | #### Hỗ trợ tin nhắn | Trường | Văn bản | Tệp | Hình ảnh | |-------|------|------|-------| | `messages` | Bắt buộc ✅ | Không hỗ trợ ❌ | Không hỗ trợ ❌ | #### Tùy chọn | Tham số | Kiểu | Phạm vi | Mô tả | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Số token đầu ra tối đa. | | `top_p` | number | `0.0` - `1.0` | Giới hạn khối xác suất tích lũy cho các token ứng viên. | | `top_k` | integer | `0` - `100` | Giới hạn số lượng token ứng viên. | ### Ví dụ yêu cầu ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'text/event-stream', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'deepseek-v4-pro-text-to-text-0813', messages: [ { role: 'user', content: 'Hello' } ], stream: true, max_tokens: 500, top_p: 0.5, top_k: 1 }) }); ``` ## DeepSeek v4 Flash Text to Text ### Điểm cuối ```http POST /api/v1/chat/completions ``` ### Tham số yêu cầu #### Bắt buộc | Tham số | Kiểu | Mô tả | |-----------|------|-------------| | `model` | string | Phải là `"deepseek-v4-flash-text-to-text-0731"` | | `messages` | array | Các tin nhắn chỉ chứa văn bản theo thứ tự. Hỗ trợ vai trò `system`, `user` và `assistant`. Xem LLM API để biết cấu trúc tin nhắn. | | `stream` | boolean | `true` cho SSE, `false` cho một phản hồi JSON duy nhất. | #### Hỗ trợ tin nhắn | Trường | Văn bản | Tệp | Hình ảnh | |-------|------|------|-------| | `messages` | Bắt buộc ✅ | Không hỗ trợ ❌ | Không hỗ trợ ❌ | #### Tùy chọn | Tham số | Kiểu | Phạm vi | Mô tả | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Số token đầu ra tối đa. | | `top_p` | number | `0.0` - `1.0` | Giới hạn khối xác suất tích lũy cho các token ứng viên. | | `top_k` | integer | `0` - `100` | Giới hạn số lượng token ứng viên. | ### Ví dụ yêu cầu ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'application/json', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'deepseek-v4-flash-text-to-text-0731', messages: [ { role: 'user', content: 'Write a four-line modern poem about a programmer drinking coffee.' } ], stream: false, max_tokens: 500, top_p: 0.5, top_k: 1 }) }); ``` ## DeepSeek v4 Pro Web Search ### Điểm cuối ```http POST /api/v1/chat/completions ``` ### Tham số yêu cầu #### Bắt buộc | Tham số | Kiểu | Mô tả | |-----------|------|-------------| | `model` | string | Phải là `"deepseek-v4-pro-web-search-0813"` | | `messages` | array | Các tin nhắn chỉ chứa văn bản theo thứ tự. Hỗ trợ vai trò `system`, `user` và `assistant`. Xem LLM API để biết cấu trúc tin nhắn. | | `stream` | boolean | `true` cho SSE, `false` cho một phản hồi JSON duy nhất. | #### Hỗ trợ tin nhắn | Trường | Văn bản | Tệp | Hình ảnh | |-------|------|------|-------| | `messages` | Bắt buộc ✅ | Không hỗ trợ ❌ | Không hỗ trợ ❌ | #### Tùy chọn | Tham số | Kiểu | Phạm vi | Mô tả | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Số token đầu ra tối đa. | | `top_p` | number | `0.0` - `1.0` | Giới hạn khối xác suất tích lũy cho các token ứng viên. | | `top_k` | integer | `0` - `100` | Giới hạn số lượng token ứng viên. | ### Ví dụ yêu cầu ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'text/event-stream', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'deepseek-v4-pro-web-search-0813', messages: [ { role: 'user', content: 'What date is it today?' } ], stream: true, max_tokens: 500, top_p: 0.5, top_k: 1 }) }); ``` ## DeepSeek v4 Flash Web Search ### Điểm cuối ```http POST /api/v1/chat/completions ``` ### Tham số yêu cầu #### Bắt buộc | Tham số | Kiểu | Mô tả | |-----------|------|-------------| | `model` | string | Phải là `"deepseek-v4-flash-web-search-0731"` | | `messages` | array | Các tin nhắn chỉ chứa văn bản theo thứ tự. Hỗ trợ vai trò `system`, `user` và `assistant`. Xem LLM API để biết cấu trúc tin nhắn. | | `stream` | boolean | `true` cho SSE, `false` cho một phản hồi JSON duy nhất. | #### Hỗ trợ tin nhắn | Trường | Văn bản | Tệp | Hình ảnh | |-------|------|------|-------| | `messages` | Bắt buộc ✅ | Không hỗ trợ ❌ | Không hỗ trợ ❌ | #### Tùy chọn | Tham số | Kiểu | Phạm vi | Mô tả | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Số token đầu ra tối đa. | | `top_p` | number | `0.0` - `1.0` | Giới hạn khối xác suất tích lũy cho các token ứng viên. | | `top_k` | integer | `0` - `100` | Giới hạn số lượng token ứng viên. | ### Ví dụ yêu cầu ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'text/event-stream', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'deepseek-v4-flash-web-search-0731', messages: [ { role: 'user', content: 'What date is it today?' } ], stream: true, max_tokens: 500, top_p: 0.5, top_k: 1 }) }); ``` ## Định dạng phản hồi Các mô hình LLM DeepSeek V4 trả về phản hồi completion tương thích với OpenAI. Với `stream: true`, phản hồi là Server-Sent Events; với `stream: false`, phản hồi là một đối tượng JSON duy nhất. ### Phản hồi lỗi ```json { "error": { "code": "1001", "param": null, "message": "Authorization is empty", "type": "invalid_request_error" } } ``` ## Thực hành tốt nhất 1. **Chọn đúng biến thể:** Dùng mô hình Pro cho lập luận chất lượng cao hơn và mô hình Flash cho workload có độ trễ thấp, chi phí thấp hơn. 2. **Dùng Web Search cho sự kiện hiện tại:** Chọn Pro hoặc Flash Web Search khi câu trả lời phụ thuộc vào thông tin trực tuyến cập nhật. 3. **Tinh chỉnh tham số sampling cẩn thận:** `top_p` và `top_k` được hỗ trợ trên mọi biến thể DeepSeek v4 và có thể thay đổi độ đa dạng của đầu ra. 4. **Chỉ gửi đầu vào được hỗ trợ:** Không gửi phần tệp hoặc hình ảnh tới bất kỳ route DeepSeek v4 nào. 5. **Khớp Accept với chế độ stream:** Dùng `Accept: text/event-stream` cho yêu cầu streaming và `Accept: application/json` cho yêu cầu không streaming.