接入 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 54924b76cc
commit da1e152196
7 files changed
+203 -33

No files matched your search

+36 -24
View File
@@ -165,12 +165,6 @@ providers:
context_window: 1000000 # 第三十三轮(2026-09-24):上下文窗口(token),每日同步维护
max_output_tokens: 131072 # 最大输出(token)
protocols: ["chat/completions"]
- id: "glm-5.1"
display_name: "GLM-5.1"
type: "text"
context_window: 202752 # 第三十三轮(2026-09-24):上下文窗口(token),每日同步维护
max_output_tokens: 32768 # 最大输出(token)
protocols: ["chat/completions"]
- id: "kimi-k2.7-code"
display_name: "Kimi K2.7 Code"
type: "text"
@@ -258,12 +252,6 @@ providers:
context_window: 512000 # 第三十三轮(2026-09-24):上下文窗口(token),每日同步维护
max_output_tokens: 128000 # 最大输出(token)
protocols: ["chat/completions", "messages"]
- id: "minimax-m2.5"
display_name: "MiniMax M2.5"
type: "text"
context_window: 204800 # 第三十三轮(2026-09-24):上下文窗口(token),每日同步维护
max_output_tokens: 65536 # 最大输出(token)
protocols: ["chat/completions", "messages"]
- id: "qwen3.8-max"
display_name: "Qwen3.8 Max"
type: "text"
@@ -276,24 +264,12 @@ providers:
context_window: 1000000 # 第三十三轮(2026-09-24):上下文窗口(token),每日同步维护
max_output_tokens: 131072 # 最大输出(token)
protocols: ["chat/completions", "messages"]
- id: "qwen3.7-max"
display_name: "Qwen3.7 Max"
type: "text"
context_window: 1000000 # 第三十三轮(2026-09-24):上下文窗口(token),每日同步维护
max_output_tokens: 65536 # 最大输出(token)
protocols: ["chat/completions", "messages"]
- id: "qwen3.7-plus"
display_name: "Qwen3.7 Plus"
type: "text"
context_window: 1000000 # 第三十三轮(2026-09-24):上下文窗口(token),每日同步维护
max_output_tokens: 65536 # 最大输出(token)
protocols: ["chat/completions", "messages"]
- id: "qwen3.6-plus"
display_name: "Qwen3.6 Plus"
type: "text"
context_window: 262144 # 第三十三轮(2026-09-24):上下文窗口(token),每日同步维护
max_output_tokens: 65536 # 最大输出(token)
protocols: ["chat/completions", "messages"]
# ── 三条线全通(实测 chat / messages / responses 均 200,
# 非文档线另经流式 + 工具调用复核) ────────────────
- id: "deepseek-v4.1-flash"
@@ -386,6 +362,42 @@ providers:
# 协议线取自官方 Endpoints 表,未逐线实测(现网其它模型是实测过的)
protocols: ["chat/completions"]
free: true # 官方价格表标 Free
# ── Dots AI(小红书 Dots Studio,第三十六轮新增)──────────────
# 官方文档:https://dots.ai/platform/docs(2026-09-28 通读)
# · 基础地址 https://note3-prev-api.askdiandian.com,两条线:
# POST /v1/chat/completions(OpenAI 兼容)/ POST /v1/messages(Anthropic 兼容)
# · 鉴权是**自定义头 `api-key: <KEY>`** —— 既不是 Authorization: Bearer,也不是
# x-api-key,所以第三十六轮给网关**新增了 `api-key` 这种鉴权样式**(config.AUTH_STYLES)。
# · /v1/messages 还需固定头 anthropic-version: 2023-06-01(官方示例里带)。
# · 官方限流按**单个 API Key** 计:60 次/分钟、1,500,000 Tokens/分钟 → 这里取 1 QPS
# (网关限流桶就是按 Key 分的,语义一致)。
dots:
name: "Dots AI(小红书)"
base_url: "https://note3-prev-api.askdiandian.com/v1"
auth:
token_env: "DOTS_API_KEY"
rate_limit_rps: 1.0 # 官方 60 次/分钟(按单个 Key)
endpoints:
chat/completions:
path: "/chat/completions"
auth: "api-key"
messages:
path: "/messages"
auth: "api-key"
headers:
anthropic-version: "2023-06-01"
models:
# 目前官方只有这一个模型(模型定价表里仅此一行)。
# 上下文窗口 512K 是官方文档明写的:`dots3-note-prev 的上下文窗口上限为 524,288 Token`,
# 且「输入 + max_tokens ≤ 该上限」。
- id: "dots3-note-prev"
display_name: "Dots3 Note Prev(免费体验)"
type: "text"
vision: true # 官方支持图片/视频/音频输入(示例见文档)
free: true # 官方定价表标「免费体验」,恢复收费前会提前告知
protocols: ["chat/completions", "messages"]
context_window: 524288 # 官方文档明确 512K
# max_output_tokens 官方未给上限("省略时由服务端默认策略决定")→ 留空不猜
# ── 虚拟模型 id(别名,第三十一轮)──────────────────────────
# 客户端固定写 model: wjd,实际转发到哪个真实模型由**管理员在模型页选**(也可以改这里)。
# · 只走 chat/completions(OpenAI)格式:用 /v1/messages、/v1/responses 打 wjd 会在入口