接入 Dots AI(小红书)+ 新增 api-key 鉴权样式

老板要求:「查看 https://dots.ai/platform/docs 文档,帮我在 ai 网关上配置 dots.ai 的
供应商」(API Key 由老板提供,落 data/.env,不入库、不写进任何提交内容)。

文档要点(通读):base https://note3-prev-api.askdiandian.com/v1;两条线
POST /v1/chat/completions(OpenAI 兼容)与 POST /v1/messages(Anthropic 兼容,需固定头
anthropic-version: 2023-06-01);**认证是自定义头 `api-key: <KEY>`**(既不是 Bearer 也不是
x-api-key);模型 dots3-note-prev 上下文窗口 512K(524,288)、当前免费体验;
官方限流按单个 Key 计 60 次/分钟、1,500,000 Tokens/分钟。

改动:
- 新增鉴权样式 `api-key`(AUTH_STYLES 由 bearer/x-api-key/none 扩为四种):适配器
  auth_headers() 按线发 `api-key: <token>`;静态头里残留的同名头一并剥掉再按线补;
  解析期校验接受该值、乱写的(api_key 下划线)仍被拒。
- data/gateway.yaml 新增 dots 供应商:两条线各自声明 path/auth,messages 线带
  anthropic-version;rate_limit_rps: 1.0(= 官方 60/分钟,按 Key);模型 dots3-note-prev
  (context_window 524288、vision: true、free: true、双协议线;官方未给最大输出上限→留空不猜)。
- 顺带补 Anthropic 口径的缓存统计:其 input_tokens 不含缓存部分,缓存命中在
  cache_read_input_tokens、写缓存在 cache_creation_input_tokens(三者互斥)。_usage_detail()
  改为分口径:OpenAI 的 prompt_tokens 已含缓存;Anthropic 三者相加为输入总量、缓存取
  cache_read_input_tokens —— 否则 messages 线的缓存量永远记 0(接 Dots 时实测到)。

上线实测(重启后,两条线各一次瘦请求,均免费):
  POST /v1/chat/completions → 200 usage{prompt 17, completion 8}
  POST /v1/messages         → 200 usage{input 17, output 8}
  /v1/models:42 个模型,dots3-note-prev 带 context_window 524288 / 双协议线 / free
  指标:calls{dots3-note-prev: ok 1}、tokens{prompt 14, completion 4}

测试:新增「Dots 配置 + api-key 样式(含解析期拒绝非法值)」与「Anthropic 缓存口径」两条
回归;既有 test_load_config_providers 供应商集合更新为四家。206 → 208 全过。
This commit is contained in:
api-gateway committed 2026-09-29 09:40:16 +08:00
1 parent c68a76cb8c
commit 15a1c13711
7 files changed
+203 -33

No files matched your search

+29
View File
@@ -47,6 +47,7 @@ api-gateway/
| Agnes AI | `https://api.agnes-ai.cn/v1` | Bearer | 10 个模型:4 text(`agnes-3.0-flash` 旗舰、`agnes-2.5-flash` 支持图像输入)、3 image、3 video;其中 **6 个免费 + 1 个限时免费**(`agnes-video-2.5-flash`,见「模型清单同步」) |
| 火山方舟 Coding | `https://ark.cn-beijing.volces.com/api/coding/v3` | Bearer | `ark-code-latest`(text) |
| OpenCode Go | `https://opencode.ai/zen/go/v1` | Bearer + `x-opencode-session` | 35 个模型,含 **1 个免费**(`space-bunny-free`,见下方小节) |
| **Dots AI(小红书)** | `https://note3-prev-api.askdiandian.com/v1` | **自定义头 `api-key`** | `dots3-note-prev`(text + 视觉,**512K**,**免费体验**) |
> OpenCode Go 是每月订阅的编程模型入口(不在订阅内按 token 额外计费)。官方硬性要求每个
> `/chat/completions` 带 **`x-opencode-session`**(缺失直接 400),并建议专属 `User-Agent`。
@@ -118,6 +119,34 @@ api-gateway/
> Agnes 的图像/视频走自有端点,通过供应商配置里的 `media` 段指定。
### Dots AI(小红书,第三十六轮 2026-09-28)
官方文档:<https://dots.ai/platform/docs>(通读后按下面接入)。
| 项 | 值 |
| --- | --- |
| Base URL | `https://note3-prev-api.askdiandian.com/v1` |
| 协议线 | `POST /v1/chat/completions`(OpenAI 兼容)、`POST /v1/messages`(Anthropic 兼容,需固定头 `anthropic-version: 2023-06-01`) |
| **认证** | **自定义头 `api-key: <KEY>`** —— 既不是 `Authorization: Bearer`,也不是 `x-api-key` |
| 模型 | `dots3-note-prev`:**上下文窗口 524,288(512K)**;官方未给最大输出上限("省略时由服务端默认策略决定")→ 配置留空不猜 |
| 能力 | 文本 / 图片 / 视频 / 音频输入、工具调用;OpenAI 线 `chat_template_kwargs.enable_thinking` 控制深度思考,Anthropic 线用 `thinking.type` |
| 计费 | **当前免费体验**(恢复收费前会提前告知)→ 配置 `free: true`,页面上打「免费」标 |
| 限流 | 官方按**单个 API Key** 计:**60 次/分钟**、1,500,000 Tokens/分钟 → 配置 `rate_limit_rps: 1.0`(网关限流桶按 Key 分,语义一致) |
**为它新增的鉴权样式 `api-key`**:`AUTH_STYLES` 原有 `bearer` / `x-api-key` / `none`,现加
`api-key`。用法:`providers.<key>.endpoints.<protocol>.auth: "api-key"` → 适配器在
`auth_headers()` 里发 `api-key: <token>`;静态头里残留的同名头同样会被剥掉再按线补上
(与 Bearer / x-api-key 一致)。**上线实测**:两条线各发一次瘦请求均 200,
`/v1/chat/completions` 回 `usage{prompt 17, completion 8}`,
`/v1/messages` 回 `usage{input 17, output 8}`。
**顺带补的一条口径**(接 Dots 时实测发现):Anthropic 系的 usage 里 `input_tokens`
**不含**缓存部分 —— 缓存命中在 `cache_read_input_tokens`、写缓存在 `cache_creation_input_tokens`
(三者互斥)。因此 `_usage_detail()` 现在分口径计算:OpenAI 口径 `prompt_tokens` 已含缓存;
**Anthropic 口径 = 三者相加为输入总量**、缓存命中取 `cache_read_input_tokens` ——
否则 messages 线的缓存量永远记成 0。
## 虚拟模型 id(别名 `wjd`,第三十一轮)
给客户端一个**名字固定**的入口:客户端永远只写 `model: wjd`,实际转发到你选的哪个真实模型