Files
xiaoyin-gateway/data/gateway.yaml
T
小银 fb5769047f 第三十一轮: 虚拟模型 id(别名 wjd)—— 客户端固定模型名,映射到哪个真实模型由管理员在页面上选
- config: AliasSpec{enabled,target,note} + GatewayConfig.aliases + resolve_alias/alias_of;
  保存期四条硬规则(目标存在 / 必须是文本模型且支持 chat/completions / 不得与真实模型 id 重名 /
  启用却没写 target);停用时跳过 target 校验。别名不进 _model_index —— 必须显式 resolve_alias()。
- main: chat 线(含 batch)入口换 id 转发;messages/responses 打别名 400 指路(不打上游);
  images/videos 明确 400 拒绝;/v1/models 注入别名条目(alias_of + 继承目标能力);
  流式 chunk 统一回显请求名(非别名调用零变化);_log_alias_changes 记指向变更(含谁改的)。
- settings: 面板 aliases 段(按段合并,不提交则沿用原文)+ 渲染 yaml 时带说明注释。
- web: Models 页「虚拟模型 id(别名)」卡片(admin 开关 + 目标下拉,非 chat/completions 置灰;
  member 只读一行);别名不进模型计数/测速列表/模型表;i18n 中英 753/753。
- tests: +8 条(规则与解析/目录继承/chat 端到端/另两线 400 且不打上游/媒体拒绝/测速说明/
  流式唯一模型名/面板往返 + 非法目标 400 不写盘)→ 187 passed / 0 failed。
- 生产: wjd → agnes-3.0-flash;后端 pid 1872300、前端 index-BJNJXWEY.js。
2026-09-18 23:42:34 +08:00

415 lines
13 KiB
YAML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# AI 网关配置文件(data/ 目录)
#
# ⚠ 本文件由管理页面「网关配置」生成(管理员账号),页面保存时会**整份重写**:
# 想要的历史决策/踩坑说明在 README.md(按轮次记录),这里只保留必要的现场注释。
# 手改本文件仍然有效(server.hot_reload=true 时按 mtime 自动重载),
# 但页面下次保存会以页面上的值为准 —— 改配置优先用页面。
#
# 端口默认 8808;密钥统一走 auth.token_env 指向的环境变量(本机见 .env),不在 yaml 存明文。
# 本文件是项目的唯一配置文件(run.py 默认读取;GATEWAY_CONFIG 可覆盖)。
# ── 供应商 + 模型清单 ───────────────────────────────────
# auth.token_env 指向存放密钥的环境变量;auth.token 只有在不用环境变量时才填(明文)。
# media 段留空 = 该供应商不支持图像/视频(Agnes 是自有非标准端点,故单独覆盖)。
# models.type: text | image | video;vision: 该模型是否支持图像输入(带图对话会被优先排到链首)。
providers:
agnes:
name: Agnes AI
base_url: https://api.agnes-ai.cn/v1
auth:
token_env: AGNES_API_KEY
token: ''
extra_headers: {}
rate_limit_rps: null
requires_session_header: false
endpoints:
chat/completions:
path: /chat/completions
auth: bearer
headers: {}
messages:
path: /messages
auth: x-api-key
headers:
anthropic-version: '2023-06-01'
responses:
path: /responses
auth: bearer
headers: {}
media:
image_endpoint: /images/generations
image_default_size: 1K
video_create_endpoint: /videos
video_poll_base: https://api.agnes-ai.cn
video_poll_path: /agnesapi
video_model_name: agnes-video-2.5-flash
models:
- id: agnes-3.0-flash
display_name: Agnes 3.0 Flash
type: text
vision: true
protocols:
- chat/completions
- id: agnes-2.5-flash
display_name: Agnes 2.5 Flash
type: text
vision: true
protocols:
- chat/completions
- id: agnes-image-2.5-flash
display_name: Agnes Image 2.5 Flash
type: image
vision: false
protocols:
- chat/completions
- id: agnes-video-2.5-flash
display_name: Agnes Video 2.5 Flash
type: video
vision: false
protocols:
- chat/completions
volc_engine:
name: 火山方舟 Coding Plan
base_url: https://ark.cn-beijing.volces.com/api/coding/v3
auth:
token_env: VOLC_API_KEY
token: ''
extra_headers: {}
rate_limit_rps: null
requires_session_header: false
endpoints:
chat/completions:
path: /chat/completions
auth: bearer
headers: {}
messages:
path: /messages
auth: x-api-key
headers:
anthropic-version: '2023-06-01'
responses:
path: /responses
auth: bearer
headers: {}
media:
image_endpoint: null
image_default_size: null
video_create_endpoint: null
video_poll_base: null
video_poll_path: null
video_model_name: null
models:
- id: ark-code-latest
display_name: 火山方舟 ark-code-latest
type: text
vision: false
protocols:
- chat/completions
opencode:
name: OpenCode Go
base_url: https://opencode.ai/zen/go/v1
auth:
token_env: OPENCODE_API_KEY
token: ''
extra_headers:
User-Agent: api-gateway/2.4.0 (jakon opencode-go)
rate_limit_rps: null
requires_session_header: true
endpoints:
chat/completions:
path: /chat/completions
auth: bearer
messages:
path: /messages
auth: x-api-key
headers:
anthropic-version: '2023-06-01'
responses:
path: /responses
auth: bearer
media:
image_endpoint: null
image_default_size: null
video_create_endpoint: null
video_poll_base: null
video_poll_path: null
video_model_name: null
models:
- id: glm-5.3-flash
display_name: GLM-5.3-Flash
type: text
protocols:
- chat/completions
vision: false
- id: glm-5.3
display_name: GLM-5.3
type: text
protocols:
- chat/completions
vision: false
- id: glm-5.2
display_name: GLM-5.2
type: text
protocols:
- chat/completions
vision: false
- id: glm-5.1
display_name: GLM-5.1
type: text
protocols:
- chat/completions
vision: false
- id: kimi-k2.7-code
display_name: Kimi K2.7 Code
type: text
protocols:
- chat/completions
params:
temperature: 1
vision: false
- id: kimi-k2.6
display_name: Kimi K2.6
type: text
protocols:
- chat/completions
vision: false
- id: longcat-2.0
display_name: LongCat 2.0
type: text
protocols:
- chat/completions
vision: false
- id: mimo-v2.5
display_name: MiMo V2.5
type: text
protocols:
- chat/completions
vision: false
- id: mimo-v2.5-pro
display_name: MiMo V2.5 Pro
type: text
protocols:
- chat/completions
vision: false
- id: hy4-preview
display_name: Hy4 Preview
type: text
protocols:
- chat/completions
vision: false
- id: hy3
display_name: Hy3
type: text
protocols:
- chat/completions
vision: false
- id: kimi-k3
display_name: Kimi K3
type: text
protocols:
- chat/completions
- messages
vision: false
- id: minimax-m3
display_name: MiniMax M3
type: text
protocols:
- chat/completions
- messages
vision: false
- id: minimax-m2.5
display_name: MiniMax M2.5
type: text
protocols:
- chat/completions
- messages
vision: false
- id: qwen3.8-max
display_name: Qwen3.8 Max
type: text
protocols:
- chat/completions
- messages
vision: false
- id: qwen3.8-flash
display_name: Qwen3.8 Flash
type: text
protocols:
- chat/completions
- messages
vision: false
- id: qwen3.7-max
display_name: Qwen3.7 Max
type: text
protocols:
- chat/completions
- messages
vision: false
- id: qwen3.7-plus
display_name: Qwen3.7 Plus
type: text
protocols:
- chat/completions
- messages
vision: false
- id: qwen3.6-plus
display_name: Qwen3.6 Plus
type: text
protocols:
- chat/completions
- messages
vision: false
- id: deepseek-v4.1-flash
display_name: DeepSeek V4.1 Flash
type: text
vision: true
protocols:
- chat/completions
- messages
- responses
- id: deepseek-v4-pro
display_name: DeepSeek V4 Pro
type: text
protocols:
- chat/completions
- messages
- responses
vision: false
- id: deepseek-v4-flash
display_name: DeepSeek V4 Flash
type: text
protocols:
- chat/completions
- messages
- responses
vision: false
- id: deepseek-v4-flash-vision-exp
display_name: DeepSeek V4 Flash Vision Exp
type: text
vision: true
protocols:
- chat/completions
- messages
- responses
- id: minimax-m2.7
display_name: MiniMax M2.7
type: text
protocols:
- messages
vision: false
- id: union-alpha
display_name: Union Alpha Free
type: text
protocols:
- messages
vision: false
- id: grok-4.6
display_name: Grok 4.6
type: text
protocols:
- responses
vision: false
- id: gpt-5.6-luna
display_name: GPT 5.6 Luna
type: text
protocols:
- responses
vision: false
- id: muse-spark-1.3-contributor
display_name: Muse Spark 1.3 Contributor
type: text
protocols:
- responses
vision: false
- id: muse-spark-1.2-contributor
display_name: Muse Spark 1.2 Contributor
type: text
protocols:
- responses
vision: false
# ── 虚拟模型 id(别名,第三十一轮)──────────────────────
# 给客户端一个"名字固定"的入口:客户端永远只写 model: wjd,实际转发到哪个真实模型
# 由这里决定(页面上改:供应商与模型页 → 虚拟模型 wjd → 单选 + 保存)。
# 规则(保存时校验,手改 yaml 一样拦):
# · 只走 chat/completions(OpenAI)格式;用 /v1/messages、/v1/responses 打 wjd 会在入口 400;
# · target 必须是**存在的文本模型**且支持 chat/completions(面板里其余模型置灰);
# · 别名 id 不能和真实模型 id 重名;
# · 别名不复制目标的配置(协议线/视觉/强制参数/定价全部继承 target,一处修改全局生效);
# · enabled: false = 该 id 不存在(等同没配),停用时不校验 target。
# 别名不进 /v1/models/speedtest(测速请测它指向的模型),但会出现在 /v1/models 里(带 alias_of)。
aliases:
wjd:
enabled: true
target: agnes-3.0-flash
note: 老板的固定入口(默认指向旗舰,随时可在页面上改)
# ── 服务与运维开关 ──────────────────────────────────────
# host/port/graceful_shutdown/docs_enabled/hot_reload 这几项**改完要重启进程**才生效,
# 其余每请求读取,页面保存即生效。
# 安全相关:health_auth(/health/* 是否鉴权)、webhook_allow_private(视频回调是否允许内网地址)、
# docs_enabled(FastAPI 文档,默认关)、auth_fail_limit_per_min(同源 IP 每分钟鉴权失败上限)。
# cors_origins 写 ["*"] 表示任意站点都能跨域驱动本网关(会把上游额度暴露给陌生网页),
# 生产建议收敛成可信前端域名白名单。
server:
host: 127.0.0.1
port: 8808
timeout: 120
retry: 3
health_auth: false
hot_reload: true
hot_reload_interval: 15
metrics_enabled: true
rate_limit_rps: null
max_body_size: 2000000
cors_origins:
- '*'
graceful_shutdown: 30
batch_max_concurrency: 16
batch_max_items: 64
webhook_allow_private: false
docs_enabled: false
auth_fail_limit_per_min: 20
# ── 供应商熔断 ──────────────────────────────────────────
# 某供应商在 window 秒内失败达到 failure_threshold 次就熔断 cooldown 秒,
# 期间直接跳过它(不再白等),让 fallback 快速切到健康供应商。
circuit:
enabled: true
failure_threshold: 3
cooldown: 30
window: 10
# ── 可观测性 ────────────────────────────────────────────
# log_level 支持 DEBUG/INFO/WARNING/ERROR;log_json=true 输出结构化 JSON 行(接 ELK)。
# access_log_maxlen = 访问日志环形缓冲长度(日志页「已加载 N 条」的上限)。
observability:
log_level: INFO
log_json: false
access_log_maxlen: 500
# ── 定价(人民币 / 百万 token,用于 /v1 响应里估算成本) ─
# 不配则该模型不返回 estimated_cost_cny(不影响调用)。
pricing:
per_model:
agnes-3.0-flash:
input: 0.35
output: 1.0
agnes-2.5-flash:
input: 0.0
output: 0.0
ark-code-latest:
input: 0.5
output: 2.0
# ── 媒体下载代理白名单 ──────────────────────────────────
# 生成的图片/视频挂在第三方 CDN 上且不带 CORS 头,浏览器 fetch 不到 blob、跨域 <a download>
# 也不生效 —— 所以由网关代拉一次并加 Content-Disposition: attachment。
# 安全:这是全网关唯一一个服务端主动出网的接口,只有这里列出的域名(含子域)允许被代下载,
# 且解析出的 IP 必须是公网地址;allowed_hosts 为空 = 该功能整体关闭。
# 换了供应商/CDN 域名时,往这里加一条即可(如 volc 的 tos-*.volces.com)。
download:
allowed_hosts:
- cos-platform-outputs.agnes-ai.cn
- maas-watermark-prod-new.cn-wlcb.ufileos.com
max_bytes: 67108864
# ── 网关入口鉴权 ────────────────────────────────────────
# 账号与 API Key 由页面管理,存在 data/users.json(见 app/users.py):
# 管理员在「用户管理」建账号,各账号在「设置 → 我的 API Key」自助铸 Key。
# 本文件里没有任何用户/密钥,只有会话时长这一个开关。
auth:
session_ttl_minutes: 1440