# 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`。