From ef009edd2949f49db1a4a9074538298f68594d37 Mon Sep 17 00:00:00 2001 From: 6vision Date: Mon, 23 Mar 2026 21:43:51 +0800 Subject: [PATCH] docs(deepseek): update config guides for independent DeepSeek module Update DeepSeek docs (zh/en/ja) and README to reflect the new dedicated deepseek_api_key / deepseek_api_base config fields, with backward compatibility notes. Made-with: Cursor --- README.md | 27 ++++++++++++++++++++------- docs/en/models/deepseek.mdx | 26 +++++++++++++++++++------- docs/ja/models/deepseek.mdx | 26 +++++++++++++++++++------- docs/models/deepseek.mdx | 26 +++++++++++++++++++------- 4 files changed, 77 insertions(+), 28 deletions(-) diff --git a/README.md b/README.md index cc9de579..99cb3d9d 100644 --- a/README.md +++ b/README.md @@ -155,6 +155,8 @@ pip3 install -r requirements-optional.txt "claude_api_base": "https://api.anthropic.com/v1", # Claude API 地址，修改可接入三方代理平台 "gemini_api_key": "", # Gemini API Key "gemini_api_base": "https://generativelanguage.googleapis.com", # Gemini API地址 + "deepseek_api_key": "", # DeepSeek API Key + "deepseek_api_base": "https://api.deepseek.com/v1", # DeepSeek API 地址，可修改为第三方代理 "open_ai_api_key": "", # OpenAI API Key "open_ai_api_base": "https://api.openai.com/v1", # OpenAI API 地址 "linkai_api_key": "", # LinkAI API Key @@ -472,20 +474,31 @@ API Key创建：在 [控制台](https://aistudio.google.com/app/apikey?hl=zh-cn) 2. 填写配置 +方式一：官方接入（推荐）： + ```json { "model": "deepseek-chat", - "open_ai_api_key": "sk-xxxxxxxxxxx", - "open_ai_api_base": "https://api.deepseek.com/v1", - "bot_type": "openai" - + "deepseek_api_key": "sk-xxxxxxxxxxx" } ``` - - `bot_type`: OpenAI兼容方式 - `model`: 可填 `deepseek-chat、deepseek-reasoner`，分别对应的是 DeepSeek-V3 和 DeepSeek-R1 模型 - - `open_ai_api_key`: DeepSeek平台的 API Key - - `open_ai_api_base`: DeepSeek平台 BASE URL + - `deepseek_api_key`: DeepSeek平台的 API Key + - `deepseek_api_base`: 可选，默认为 `https://api.deepseek.com/v1`，可修改为第三方代理地址 + +方式二：OpenAI兼容方式接入： + +```json +{ + "model": "deepseek-chat", + "bot_type": "openai", + "open_ai_api_key": "sk-xxxxxxxxxxx", + "open_ai_api_base": "https://api.deepseek.com/v1" +} +``` + +> 注：已有用户如果之前通过 `open_ai_api_key` / `open_ai_api_base` 配置 DeepSeek，无需修改，程序会自动兼容。推荐新用户使用方式一的独立配置，避免与 OpenAI 配置冲突。
diff --git a/docs/en/models/deepseek.mdx b/docs/en/models/deepseek.mdx index 3d7f721c..8d76de8a 100644 --- a/docs/en/models/deepseek.mdx +++ b/docs/en/models/deepseek.mdx @@ -3,7 +3,22 @@ title: DeepSeek description: DeepSeek model configuration --- -Use OpenAI-compatible configuration: +Option 1: Native integration (recommended): + +```json +{ + "model": "deepseek-chat", + "deepseek_api_key": "YOUR_API_KEY" +} +``` + +| Parameter | Description | +| --- | --- | +| `model` | `deepseek-chat` (DeepSeek-V3), `deepseek-reasoner` (DeepSeek-R1) | +| `deepseek_api_key` | Create at [DeepSeek Platform](https://platform.deepseek.com/api_keys) | +| `deepseek_api_base` | Optional, defaults to `https://api.deepseek.com/v1`. Can be changed to a third-party proxy | + +Option 2: OpenAI-compatible configuration: ```json { @@ -14,9 +29,6 @@ Use OpenAI-compatible configuration: } ``` -| Parameter | Description | -| --- | --- | -| `model` | `deepseek-chat` (DeepSeek-V3), `deepseek-reasoner` (DeepSeek-R1) | -| `bot_type` | Must be `openai` (OpenAI-compatible mode) | -| `open_ai_api_key` | Create at [DeepSeek Platform](https://platform.deepseek.com/api_keys) | -| `open_ai_api_base` | DeepSeek platform BASE URL | + + Existing users who configured DeepSeek via `open_ai_api_key` / `open_ai_api_base` do not need to change anything — the program will automatically fall back to those fields. New users are recommended to use Option 1 to avoid config conflicts with OpenAI. + diff --git a/docs/ja/models/deepseek.mdx b/docs/ja/models/deepseek.mdx index a68a8f3b..200be8d4 100644 --- a/docs/ja/models/deepseek.mdx +++ b/docs/ja/models/deepseek.mdx @@ -3,7 +3,22 @@ title: DeepSeek description: DeepSeekモデルの設定 --- -OpenAI互換の設定を使用します: +方法1：公式接続（推奨）： + +```json +{ + "model": "deepseek-chat", + "deepseek_api_key": "YOUR_API_KEY" +} +``` + +| パラメータ | 説明 | +| --- | --- | +| `model` | `deepseek-chat` (DeepSeek-V3)、`deepseek-reasoner` (DeepSeek-R1) | +| `deepseek_api_key` | [DeepSeek Platform](https://platform.deepseek.com/api_keys)で作成 | +| `deepseek_api_base` | オプション、デフォルトは `https://api.deepseek.com/v1`。サードパーティプロキシに変更可能 | + +方法2：OpenAI互換方式： ```json { @@ -14,9 +29,6 @@ OpenAI互換の設定を使用します: } ``` -| パラメータ | 説明 | -| --- | --- | -| `model` | `deepseek-chat` (DeepSeek-V3)、`deepseek-reasoner` (DeepSeek-R1) | -| `bot_type` | `openai`を指定（OpenAI互換モード） | -| `open_ai_api_key` | [DeepSeek Platform](https://platform.deepseek.com/api_keys)で作成 | -| `open_ai_api_base` | DeepSeekプラットフォームのBASE URL | + + 既存ユーザーが `open_ai_api_key` / `open_ai_api_base` で DeepSeek を設定していた場合、変更は不要です。プログラムは自動的にフォールバックします。新規ユーザーは OpenAI 設定との競合を避けるため、方法1の使用を推奨します。 + diff --git a/docs/models/deepseek.mdx b/docs/models/deepseek.mdx index 32d9b5b7..d62bac82 100644 --- a/docs/models/deepseek.mdx +++ b/docs/models/deepseek.mdx @@ -3,20 +3,32 @@ title: DeepSeek description: DeepSeek 模型配置 --- -通过 OpenAI 兼容方式接入： +方式一：官方接入（推荐）： ```json { "model": "deepseek-chat", - "open_ai_api_key": "YOUR_API_KEY", - "open_ai_api_base": "https://api.deepseek.com/v1", - "bot_type": "openai" + "deepseek_api_key": "YOUR_API_KEY" } ``` | 参数 | 说明 | | --- | --- | | `model` | `deepseek-chat`（DeepSeek-V3）、`deepseek-reasoner`（DeepSeek-R1） | -| `bot_type` | 固定为 `openai`（OpenAI 兼容方式） | -| `open_ai_api_key` | 在 [DeepSeek 平台](https://platform.deepseek.com/api_keys) 创建 | -| `open_ai_api_base` | DeepSeek 平台 BASE URL | +| `deepseek_api_key` | 在 [DeepSeek 平台](https://platform.deepseek.com/api_keys) 创建 | +| `deepseek_api_base` | 可选，默认为 `https://api.deepseek.com/v1`，可修改为第三方代理地址 | + +方式二：OpenAI 兼容方式接入： + +```json +{ + "model": "deepseek-chat", + "bot_type": "openai", + "open_ai_api_key": "YOUR_API_KEY", + "open_ai_api_base": "https://api.deepseek.com/v1" +} +``` + + + 已有用户如果之前通过 `open_ai_api_key` / `open_ai_api_base` 配置 DeepSeek，无需修改，程序会自动兼容。推荐新用户使用方式一的独立配置，避免与 OpenAI 配置冲突。 +