zai-org / zai-org/feedback

[Docs] 「连接模型」文档的 DeepSeek 示例使用了已下线的模型名

Open Beginner friendly
#627 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

priority: P2
Dominant language
No language data
Stars
22
Forks
1
PR merge metrics
No merged PRs in 30d

Description

使用环境

问题

该页的 DeepSeek 示例给出的模型 ID 是:

deepseek-chat、deepseek-reasoner

这两个模型名在 DeepSeek 官方文档中已不存在。DeepSeek 当前的模型 ID 为:

  • deepseek-flash(对应 DeepSeek-V4.1-Flash)
  • deepseek-v4-pro(对应 DeepSeek-V4-Pro-0813)

参考:https://api-docs.deepseek.com/quick_start/pricing

复现步骤

  1. 设置 → 模型设置 → 添加供应商
  2. 名称填 DeepSeek,OpenAI 接口地址填 https://api.deepseek.com/v1,填入平台 Key
  3. 按文档示例「添加模型」,输入 deepseek-chat
  4. 打开启用开关,回到对话框选择该模型并发起对话

期望表现

示例应使用当前有效的模型 ID;或至少提示一句「模型名以平台当前文档为准」。

实际表现

照抄示例配置的模型已下线,对话直接调用失败。文档没有提示模型名可能变更,读者难以判断这是自己的配置问题还是模型已下线 —— 这个歧义会让排查绕远路(我在核对时才确认是模型名过期,而不是地址或 Key 的问题)。

建议

把示例中的模型 ID 更新为 deepseek-flashdeepseek-v4-pro

顺带一问(非确定结论,想确认预期行为)

同一页各厂商示例的地址格式不一致:

厂商 文档中的地址 是否含版本段
DeepSeek https://api.deepseek.com/v1
OpenAI https://api.openai.com
OpenRouter https://openrouter.ai/api

如果这些值会被直接用作 base_url,那么 OpenAI 与 OpenRouter 两条可能缺版本段(OpenRouter 官方文档给的 base URL 是 https://openrouter.ai/api/v1);如果客户端会自动补 /v1,那就没问题。

外部无法判断属于哪种,所以这里只作为疑问提出,不是断言它们有错。如果是「会自动补全」,也许值得在文档里加一句说明,因为各厂商示例格式不一致容易让用户以为自己填错了。

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start at the 「连接模型」→「自定义供应商」 section of the configuration documentation page and verify the current DeepSeek model IDs against the linked DeepSeek documentation. Update the example IDs and clarify whether provider base URLs require a version suffix or are completed automatically; done means the examples reflect current supported values and explain any URL normalization.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
74/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.