用自己的 OpenRouter 密钥为 Aurelio 装上 AI 财务顾问

原创2026-11-01 12:26:001,701 阅读

用自己的 OpenRouter 密钥为 Aurelio 装上 AI 财务顾问

Aurelio 的聊天与组合分析并不绑定某一家模型厂商,而是通过 OpenRouter 网关调用模型:你在 backend/.env 里放一把自己的 API Key,按提问次数向 OpenRouter 付费,Aurelio 本身不收订阅费。读完本文,你会掌握密钥的创建与写入方式、如何用密钥额度把花销封顶、如何为聊天与分析的不同角色挑选模型,以及 OpenRouter 退役某个模型时 Aurelio 会怎样提前告知你。文中涉及的配置项与提示语均可在 .env.example、advisor.py、model_list.py 与 websearch.py 中核实。

一把密钥管住两个功能,其余功能离线可用

按仓库的说明,Aurelio 的记账、Dashboard、Portfolio、基金穿透(look-through)、目标规划等功能不需要密钥即可工作;只有对话(chat)与投资分析(analysis)会调用模型。这一点在源码里是硬性的:advisor._client() 在构造客户端时检查 OPENROUTER_API_KEY,缺失就抛出 AdvisorError,提示你把密钥写进 backend/.env。也就是说,密钥是一道开关,而不是整个应用的启动条件。

连接步骤

  1. 在 openrouter.ai 创建账号并充值。
  2. 在 openrouter.ai/keys 创建密钥。OpenRouter 允许给单把密钥设置信用上限,强烈建议设置,详见下一节。
  3. 在 backend/ 目录中把 .env.example 复制为 .env,把密钥写在 OPENROUTER_API_KEY= 之后。
  4. 重启 Aurelio。密钥在服务启动时读取。

backend/.env 被 git 忽略,不会进入提交;.env.example 是受版本控制的模板,OPENROUTER_API_KEY= 必须保持为空,绝不能把真实密钥写进模板。仓库中的 .env.example 开头就用注释写明了这条约定。

一个最小可用的 .env 只有两行含义:

# 唯一的必填项,只被聊天与分析读取
OPENROUTER_API_KEY=sk-or-v1-你的密钥

# 可选:留空则回退到后端内置默认模型
OPENROUTER_MODEL=

.env.example 里还预留了 OPENROUTER_ANALYST_MODEL、OPENROUTER_CONFIDANT_MODEL、OPENROUTER_CHAT_MODEL 三个可选项,以及一个可选的数据文件路径:

# 可选:用另一个 SQLite 数据库。默认 backend/data.db
# ./start.ps1 -Demo 与 ./start.sh --demo 会自动指向 backend/demo.db
# DATABASE_URL=sqlite:///path/to/another.db

用密钥额度封顶:为什么要留出余量

OpenRouter 把密钥限额描述为「配置在单个 API Key 上的可选消费上限」,这是最直接的一道保护:无论发生什么,花费到该数字即止。

但要注意它的预授权机制。每次请求之前,OpenRouter 会按这次请求可能产生的最高成本冻结额度:输入 token 加上应用允许的最长回答。Aurelio 的每个请求都会显式声明 max_tokens,这两个数字在源码里是常量:

请求类型 常量 取值 在默认模型上的输出上限成本
聊天的一轮 CHAT_MAX_TOKENS 8,192 约 $0.16
分析的一个步骤 STEP_MAX_TOKENS 16,384 约 $0.33
一次网络搜索 websearch.MAX_TOKENS 1,024 约 $0.0005

见 advisor.py 的 ceiling 定义 与 websearch.py。因此,如果密钥剩余额度不够冻结这一笔「输入 + 最长输出」,请求会被直接拒绝,即使真实回答只花两分钱。给密钥留出 0.2 到 0.4 美元以上的余量,就不会被这种预授权卡住。

这些上限并非随手写死:CHAT_MAX_TOKENS 取自历史上最长的回复(2,316 token,其中 626 是推理 token),STEP_MAX_TOKENS 取自分析中最长的一步(4,361 token,其中 1,584 是推理),并且 OpenRouter 会把推理 token 计入 max_tokens。回答被截断时,Aurelio 会在提示语里说出具体数字,而不是含糊地说「到达长度限制」——参见 advisor._unfinished()。

被拒时,Aurelio 说清是哪种「钱不够」

OpenRouter 的 402 响应会在 error.metadata.limit_source 告知资金受限的来源,Aurelio 按这个字段分支,而不是去猜错误文案。处理逻辑在 advisor._short_of_credit():

limit_source Aurelio 的说法 给出的解决办法
openrouter_key_limit 密钥在其限额下还能花的钱不够这次请求 在 openrouter.ai 的 Settings → Keys 提高或移除密钥限额,然后重试
openrouter_credits 密钥背后账号的余额不够这次请求 在 Settings → Credits 充值后重试
openrouter_in_flight_budget 账号上仍在运行的请求占满了并发预算 等待若干秒(读取 retry-after)后重试;充值可提高该额度
未标注来源 密钥或账号没有这次请求所需的余额 充值或提高密钥限额后重试

如果 OpenRouter 的消息里给出了「最多可写 N token,但只能支付 M token」这样的数字,Aurelio 会把两个数字一起读出来,方便你判断是「额度太小」还是「钱真的没了」。这段正则解析见 advisor.py 的 _AFFORDS。

选择回答问题的模型

默认模型是 anthropic/claude-opus-5.5,输入 $4 / 百万 token、输出 $20 / 百万 token(价格于 2026 年 10 月核对)。默认选大模型是有意为之:关于钱的一个错误数字,代价高于一次慢回答。这个默认值定义在 advisor.py 的 DEFAULT_MODEL。

聊天面板里的模型菜单提供以下选项(清单定义于 chat.CURATED_MODELS):

模型 上下文 每百万 token 价格(输入 / 输出)
anthropic/claude-opus-5.5 1M $4 / $20
anthropic/claude-sonnet-4.6 1M $3 / $15
openai/gpt-6.1-sol-pro 1.05M $2 / $10
qwen/qwen3.8-max-0902 1M $2 / $6
moonshotai/kimi-k3 1M $3 / $15
moonshotai/kimi-k2.6 — 约为 K3 的六分之一

价格是 2026 年 10 月(两个 Kimi 模型为 8 月)在 OpenRouter 上核对的快照,会变化,以 OpenRouter 的模型页为准。

任何 OpenRouter 提供的模型都可以用其 slug 写进 backend/.env,写进去之后它也会出现在聊天的菜单中:

设置项 它决定什么
OPENROUTER_MODEL 所有用途的默认模型
OPENROUTER_CHAT_MODEL 菜单中未选择时聊天使用的模型
OPENROUTER_ANALYST_MODEL 分析中的分析师角色
OPENROUTER_CONFIDANT_MODEL 分析中的「知己」角色

解析顺序在 advisor.resolve_model() 中只有一行:调用方传入的模型 → OPENROUTER_MODEL → 内置默认值。角色的回退链则由 chain.ROLE_READS 描述:分析师读 OPENROUTER_ANALYST_MODEL 再到 OPENROUTER_MODEL;知己读 OPENROUTER_CONFIDANT_MODEL 再到 OPENROUTER_MODEL。

给分析的两个角色配不同模型,可以带来不同的盲区,这正是 AI 组合点评 的设计意图;两个角色用同一个模型也仍然成立,因为区分角色的是它们各自看到的内容,而不是权重。.env.example 的注释把这个取舍写得很直白:分析师盲判组合(量化工作),知己了解这个人但从不看数字(读人、选词)。

值得留意的是,「菜单里的选项」和「可配置的模型」不是一回事:菜单是精选列表,而不是把 OpenRouter 全量目录塞进下拉框。chat.available_models() 会把环境变量中配置的 slug 合并进菜单,保证你自己的选择一定在选项里,同时先按 _ENV_MODELS 收集、再补上精选清单、最后补上默认值,并用 notes.setdefault 去重,见 chat.py。

OpenRouter 退役一个模型时会发生什么

OpenRouter 的公开模型列表会给部分条目一个 expiration_date,即「该模型可能被移除的日期之后的那一天」。Aurelio 每天读一次这个列表,并在调用失败之前就把话说出来。列表中若出现近期退役日期,聊天菜单会在模型名旁显示日期(「may be retired after 2026-10-31」;菜单收起时显示「until Oct 31」),对已经被列表删除的模型则标注「no longer listed by OpenRouter」(收起时「not listed」),但不会把它从菜单里隐藏——因为曾经出现过某个模型从列表消失却仍能回答的情况。

前端这层逻辑集中在 modelMenu.ts:optionLabel() 拼出完整标签,menuFace() 为收起状态给出「名称 + until 日期 / not listed」,modelNotices() 则把后端返回的 warning 与「当前模型会搜索时会话所用的搜索模型警告」合并成提问框上方的提示行。

30 天预警窗口

从日期前 30 天起,聊天提问框上方会出现一行说明:下一个问题会发给哪个模型、退役日期、以及它在哪儿设置——是 backend/.env 里的某个变量、应用的内置默认值,还是菜单里的选择。这个窗口就是 model_list.WARN_DAYS 的取值。为什么不从读到日期那天起就说?源码注释给了理由:若某模型的日期在两个月之后,提示会在聊天里长期挂着,而用户可能早就换模型了。

分析页的卡片也会对一次运行将要调用的模型说同样的话;当当前模型支持搜索时,也会说明网络搜索所用的模型。设置项归属的措辞由 model_list.where_set() 生成,它有四种模板:

  • SET_IN_ENV:由 backend/.env 中的某几个变量设置,重启后生效;
  • BUILT_IN:应用内置默认值(advisor.DEFAULT_MODEL),可用 OPENROUTER_MODEL 覆盖;
  • PICKED:在提问框下方的菜单里选择;
  • SEARCH_SET:写在应用代码里(websearch.SEARCH_MODEL)。

模型真的停止服务时

如果 OpenRouter 直接拒绝了你设置的模型,Aurelio 会说明是哪个模型、是哪条设置选中了它,并列出 OpenRouter 仍在提供的带日期版本(如果有)。判定逻辑在 advisor._refused():只有当「400/404 拒绝」与「公开列表已无该条目」同时成立时,才会抛出 ModelGone;因为文档没有为这种情况给出措辞,而单看任何一个信号都可能误判。若列表里还有 qwen/qwen3.8-max-0902 这类带日期后缀的版本,still_listed() 会把它们点名列出来。

路由后缀的处理也在这条链上。catalog_id() 会丢弃 :nitro、:floor、:exacto、:online 这类只影响路由、从不作为列表条目的后缀,保留 :free、:batch、:thinking、:extended 这类真正的目录变体,见 catalog_id()。否则一个对 anthropic/claude-sonnet-4.6:nitro 的 400 会被误读成「模型已下线」。

读取列表的隐私与成本

读列表是每天一次对 OpenRouter 的请求,不带密钥,也不含你的任何数据:请求里没有 key、没有查询、没有 body,只有 httpx 自己的头。若是没有设置密钥,这次请求根本不会发出;某天读不到列表,应用就什么都不说,第二天再试。start_if_due() 在 main.py 的 lifespan 启动时被调用,且在后台线程执行,任何页面都不等待它。

去重与落盘做得相当克制:日期先写进 settings(键 model_list_asked_on)再发请求,所以第二个标签页、React 的第二次 effect、当天重启都不会重复请求;返回的列表存在 settings 的 model_list 键与进程内存中,只在其对应那一天使用。实现在 model_list.py。若某次调用被拒,read_now() 会立即重新拉取一次列表,并把结果作为当天副本,这样菜单说的正是你刚刚被告知的内容。

它能联网搜索吗

可以,当问题需要时——例如某家公司最近披露了什么。按 websearch.py 的实现,一次搜索是使用你的密钥向 OpenRouter 单独发起的请求,由一个小模型(Claude Haiku 5.5)执行,请求里只带查询语句,不带记录、不带对话上下文。每次搜索在发起它的那一轮之外额外花费 $0.0073 到 $0.0075。

几个值得注意的实现细节:

  • 为什么单独发请求:早期版本在每个聊天请求里声明 OpenRouter 的搜索,结果 OpenRouter 只保留请求末尾的缓存标记,导致后续每一轮都要为整个 prompt 重新付费。现在搜索是应用自己的工具(tools.SEARCH_WEB),聊天请求不再声明 OpenRouter 的搜索。
  • 参数:engine: exa、max_results: 5、max_uses: 1、max_characters: 1000,并通过 extra_body 传 max_tool_calls: 1 与 reasoning.effort: low,见 SERVER_TOOL 与 request()。
  • 不重试:超时 30 秒,max_retries=0。重试就是第二次付费搜索,而没有人要求它。
  • 保留什么:只保留 OpenRouter 以 url_citation 注解返回的页面(地址、标题、摘录),模型自己写的文字不会被采用;地址只接受 http/https,因为最终会变成可点击的链接。
  • 谁能搜:只有 anthropic/ 开头的模型会被授予搜索工具,见 tools.web_search(),因为搜索行为只在这一族模型上实测过。

常见问题

我可以直接使用 OpenAI 或 Anthropic,而不经过 OpenRouter 吗? 不改代码不行。Aurelio 调用的是 OpenRouter 的 API,由它把请求路由到你选定模型背后的公司,OpenAI 与 Anthropic 也在其中。

使用 Aurelio 必须有密钥吗? 不需要。没有密钥时,除了聊天与分析之外的一切照常工作。

改了 .env 为什么没生效? 密钥与模型变量在服务启动时读取,改完需要重启应用。

想更省一点怎么办? 可以按 AI 财务顾问到底要花多少钱 的思路:给密钥设上限、日常提问换成更便宜的模型、把大模型留给真正的决策,并在 OpenRouter 的 Activity 页面核对用量。

延伸阅读

登录后查看全文
aurelio-finance