# DeepSeek v4 API DeepSeek v4 LLM 模型的完整 API 參考,由 DeepSeek 提供支援。 ## 模型更新 ### DeepSeek v4 Pro 0813 - Flaq AI 已將 DeepSeek v4 Pro 更新至 DeepSeek 官方發布的 `deepseek-v4-pro-0813` 版本。 - 使用下方的 `0813` 模型 ID 存取正式版本。 - 原始 Pro 模型 ID 已無法使用。 | 變體 | 0813 模型 ID | 無法使用的模型 ID | |---------|---------------|----------------------| | 文字轉文字 | `deepseek-v4-pro-text-to-text-0813` | `deepseek-v4-pro-text-to-text` | | 網頁搜尋 | `deepseek-v4-pro-web-search-0813` | `deepseek-v4-pro-web-search` | ### DeepSeek v4 Flash 0731 - Flaq AI 已將 DeepSeek v4 Flash 更新至 DeepSeek 官方發布的 `deepseek-v4-flash-0731` 版本。 - 使用下方的 `0731` 模型 ID 存取更新後的版本。 - 原始 Flash 模型 ID 已無法使用。 | 變體 | 0731 模型 ID | 無法使用的模型 ID | |---------|---------------|----------------------| | 文字轉文字 | `deepseek-v4-flash-text-to-text-0731` | `deepseek-v4-flash-text-to-text` | | 網頁搜尋 | `deepseek-v4-flash-web-search-0731` | `deepseek-v4-flash-web-search` | ## 模型變體 此 API 支援四種 DeepSeek v4 模型變體: | 模型 | ID | 說明 | |-------|----|-------------| | **DeepSeek v4 Pro Text to Text** | `deepseek-v4-pro-text-to-text-0813` | 高品質文字推理與寫作 | | **DeepSeek v4 Flash Text to Text** | `deepseek-v4-flash-text-to-text-0731` | 更快、更實惠的文字生成 | | **DeepSeek v4 Pro Web Search** | `deepseek-v4-pro-web-search-0813` | 結合 DeepSeek v4 Pro 推理的網路感知回答 | | **DeepSeek v4 Flash Web Search** | `deepseek-v4-flash-web-search-0731` | 結合 DeepSeek v4 Flash 的更快網路感知回答 | ## 快速比較 | 功能 | Pro Text to Text | Flash Text to Text | Pro Web Search | Flash Web Search | |---------|------------------|------------|----------------|------------------| | 文字輸入 | 必要 ✅ | 必要 ✅ | 必要 ✅ | 必要 ✅ | | 圖片輸入 | 不支援 ❌ | 不支援 ❌ | 不支援 ❌ | 不支援 ❌ | | 檔案輸入 | 不支援 ❌ | 不支援 ❌ | 不支援 ❌ | 不支援 ❌ | | Web search | 不支援 ❌ | 不支援 ❌ | 已啟用 ✅ | 已啟用 ✅ | | 串流回應 | SSE | SSE | SSE | SSE | | `max_tokens` | 可選 | 可選 | 可選 | 可選 | | `top_p` | 可選 | 可選 | 可選 | 可選 | | `top_k` | 可選 | 可選 | 可選 | 可選 | ## DeepSeek v4 Pro Text to Text ### 端點 ```http POST /api/v1/chat/completions ``` ### 請求參數 #### 必要 | 參數 | 類型 | 說明 | |-----------|------|-------------| | `model` | string | 必須為 `"deepseek-v4-pro-text-to-text-0813"` | | `messages` | array | 依順序排列的純文字訊息。支援 `system`、`user` 和 `assistant` 角色。訊息結構請參見 LLM API。 | | `stream` | boolean | `true` 表示 SSE,`false` 表示單一 JSON 回應。 | #### 訊息支援 | 欄位 | 文字 | 檔案 | 圖片 | |-------|------|------|-------| | `messages` | 必要 ✅ | 不支援 ❌ | 不支援 ❌ | #### 可選 | 參數 | 類型 | 範圍 | 說明 | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | 最大輸出 token 數。 | | `top_p` | number | `0.0` - `1.0` | 限制候選 token 的累積機率質量。 | | `top_k` | integer | `0` - `100` | 限制候選 token 的數量。 | ### 範例請求 ```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 ### 端點 ```http POST /api/v1/chat/completions ``` ### 請求參數 #### 必要 | 參數 | 類型 | 說明 | |-----------|------|-------------| | `model` | string | 必須為 `"deepseek-v4-flash-text-to-text-0731"` | | `messages` | array | 依順序排列的純文字訊息。支援 `system`、`user` 和 `assistant` 角色。訊息結構請參見 LLM API。 | | `stream` | boolean | `true` 表示 SSE,`false` 表示單一 JSON 回應。 | #### 訊息支援 | 欄位 | 文字 | 檔案 | 圖片 | |-------|------|------|-------| | `messages` | 必要 ✅ | 不支援 ❌ | 不支援 ❌ | #### 可選 | 參數 | 類型 | 範圍 | 說明 | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | 最大輸出 token 數。 | | `top_p` | number | `0.0` - `1.0` | 限制候選 token 的累積機率質量。 | | `top_k` | integer | `0` - `100` | 限制候選 token 的數量。 | ### 範例請求 ```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 ### 端點 ```http POST /api/v1/chat/completions ``` ### 請求參數 #### 必要 | 參數 | 類型 | 說明 | |-----------|------|-------------| | `model` | string | 必須為 `"deepseek-v4-pro-web-search-0813"` | | `messages` | array | 依順序排列的純文字訊息。支援 `system`、`user` 和 `assistant` 角色。訊息結構請參見 LLM API。 | | `stream` | boolean | `true` 表示 SSE,`false` 表示單一 JSON 回應。 | #### 訊息支援 | 欄位 | 文字 | 檔案 | 圖片 | |-------|------|------|-------| | `messages` | 必要 ✅ | 不支援 ❌ | 不支援 ❌ | #### 可選 | 參數 | 類型 | 範圍 | 說明 | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | 最大輸出 token 數。 | | `top_p` | number | `0.0` - `1.0` | 限制候選 token 的累積機率質量。 | | `top_k` | integer | `0` - `100` | 限制候選 token 的數量。 | ### 範例請求 ```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 ### 端點 ```http POST /api/v1/chat/completions ``` ### 請求參數 #### 必要 | 參數 | 類型 | 說明 | |-----------|------|-------------| | `model` | string | 必須為 `"deepseek-v4-flash-web-search-0731"` | | `messages` | array | 依順序排列的純文字訊息。支援 `system`、`user` 和 `assistant` 角色。訊息結構請參見 LLM API。 | | `stream` | boolean | `true` 表示 SSE,`false` 表示單一 JSON 回應。 | #### 訊息支援 | 欄位 | 文字 | 檔案 | 圖片 | |-------|------|------|-------| | `messages` | 必要 ✅ | 不支援 ❌ | 不支援 ❌ | #### 可選 | 參數 | 類型 | 範圍 | 說明 | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | 最大輸出 token 數。 | | `top_p` | number | `0.0` - `1.0` | 限制候選 token 的累積機率質量。 | | `top_k` | integer | `0` - `100` | 限制候選 token 的數量。 | ### 範例請求 ```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 }) }); ``` ## 回應格式 DeepSeek V4 LLM 模型會傳回與 OpenAI 相容的補全回應。使用 `stream: true` 時,回應為伺服器傳送事件(SSE);使用 `stream: false` 時,回應為單一 JSON 物件。 ### 錯誤回應 ```json { "error": { "code": "1001", "param": null, "message": "Authorization is empty", "type": "invalid_request_error" } } ``` ## 最佳實務 1. **選擇合適的變體:** 對更高品質推理使用 Pro 模型;對低延遲、低成本工作負載使用 Flash 模型。 2. **針對時事使用 Web Search:** 當答案依賴最新線上資訊時,選擇 Pro 或 Flash Web Search。 3. **謹慎調整取樣參數:** `top_p` 和 `top_k` 在所有 DeepSeek v4 變體中均受支援,並會改變輸出多樣性。 4. **僅傳送受支援的輸入:** 不要向任何 DeepSeek v4 route 傳送檔案或圖片部分。 5. **讓 Accept 與 stream 模式匹配:** 串流請求使用 `Accept: text/event-stream`,非串流請求使用 `Accept: application/json`。