⚙ 我们用了哪些 AI · 透明账单
这里展示 TravelForger 用到的 AI 服务 · 想看你自己的消费明细和工具单价? → 钱包账单
💎 角色权益 + 充值套餐对照
3 种角色完整权限对比 (生成行程/翻译工具/写游记/...) + 4 档充值套餐 + FAQ — 都集中在价格页
🔑 API 凭证状态
所有API都从 .env 读取, 代码0硬编码
Google Gemini 2.5 Pro/Flash · 联网搜索 (主用)
✓ 已配置
★ 方案 F 主 LLM (2026-05) · 17/19 处 Claude 调用切到 Gemini · 单 trip ¥5.31 → ¥0.70, 省 87%, 0 品质下降
用途模块: 多日行程规划 → Gemini 2.5 Pro、玩法整合 / 机票价格洞察 / 签证 / POI 翻译 → Gemini Pro/Flash、物价 / 节假日 / 交通卡 / 文化禁忌 / 紧急电话 → Gemini Flash、翻译 / OCR / 写游记 / 纪念册 → Gemini Flash Vision、拍照菜单/路标 → Gemini Flash Vision、云端 ASR → Gemini Native Audio
免费额度: Google 联网搜索 1500 次/天 (免费!)
付费起点: Pro: 输入$1.25/M / 输出$5/M · Flash: 输入$0.075/M / 输出$0.3/M
⚠ ★ 必须配置 (主 LLM). 6 样本 A/B 实测质量不输 Sonnet 4.6, 价格只有 1/5-1/10
Anthropic Claude (一级 fallback + 专用)
✓ 已配置
Gemini 失败时一级 fallback (Sonnet 4.6 / Haiku 4.5 双模型) + 两个专用场景 (NLU 入口 + 实际花费 OCR)
用途模块: NLU 解析 → Haiku 4.5 (chat_json 接口稳定, 入口安全)、实际花费 OCR → Sonnet Vision (OCR 高准度要求)、Gemini 失败时 fallback 重试 → Sonnet 4.6 / Haiku 4.5
免费额度: 无 (按用量付费, 大部分场景由 Gemini 兜底)
付费起点: Sonnet 4.6: 输入$3/M · 输出$15/M / Haiku 4.5: 输入$1/M · 输出$5/M
⚠ 建议配置 (作为 Gemini 失败时的高可靠 fallback). 当前主用 Gemini, Claude 月扣费 ≈ ¥1-3
Google Maps Platform
✓ 已配置
国外景点/餐厅 · 路径规划 · 静态地图 · 评论摘要
用途模块: Places API (New) — 景点 / 美食 / 评论摘要、Directions API — 国外段交通、Static Maps API — 总览图 + 离线包、Photos API — POI 缩略图(通过 /api/img_proxy 代理)
免费额度: $200/月 credit (≈4 万次调用)
付费起点: 超额按各 API 计费; Places New $0.032/次, Photos $0.007/张
⚠ ⚠ 必须在 Cloud Console 启用 4 个服务: Places API (New) / Directions API / Maps Static API / Photos API; '📝 看评论摘要' 功能需要 Places API (New) 启用 + reviews 字段权限
高德开放平台 Web Service
✓ 已配置
国内景点/餐厅 · 国内路径 · 国内静态地图
用途模块: 高德POI (国内景点+美食)、高德 Direction (国内交通)、高德 Static Map (国内总览)
免费额度: 30万次/天 (个人完全够用)
付费起点: 无,免费配额超大
⚠ 国内行程必备 (Google Maps在大陆受限)
高德 JS API V2 (Web 端)
✓ 已配置
国内行程页交互地图 (可拖动/缩放/标记 POI 详情)
用途模块: interactive_map.js 国内引擎
免费额度: 30万次/天 (跟 Web Service 分开计配额)
付费起点: 无,免费配额超大
⚠ 需在高德控制台单独申请 Web端(JS API) 类型, 与 Web 服务 key 不通用
高德 JS 安全密钥 (securityJsCode)
✓ 已配置
高德 JS V2 强制要求 (2021-12 后申请的新 key 必填)
用途模块: 与 AMAP_JS_API_KEY 配套
免费额度: —
付费起点: —
⚠ 不配置会导致高德底图灰底/瓦片不加载
OpenWeatherMap
✓ 已配置
5天天气预报 · 集成到多日行程
用途模块: 天气预报 (多日行程头部)
免费额度: 1000次/天
付费起点: 60次/分钟以上 $40/月
⚠ 新key需1-2小时激活
exchangerate (无需 key)
✓ 已配置
实时汇率换算
QueueTimes (无需 key)
✓ 已配置
Disney / Universal / Six Flags 实时排队等待时间
用途模块: qa 浮窗 🎢 实时排队 按钮
免费额度: 无限制 · 无需 key (实时数据)
付费起点: —
⚠ 公共 API. 覆盖全球连锁主题乐园 (国内主题公园不在数据库内)
OpenStreetMap Tiles (无需 key)
✓ 已配置
离线地图 ZIP 内的交互瓦片
用途模块: offline_map.html (Leaflet + OSM tile)
免费额度: 无限制 · 无需 key (公共瓦片)
付费起点: —
⚠ 用户飞行/无网时降级到 Google Static Maps 截图
Web Speech API (浏览器内置)
✓ 已配置
语音输入 (STT) + 翻译朗读 (TTS)
用途模块: 🎤 同声传译 v2、🎤 OCR 翻译录音
免费额度: 浏览器内置, 无限制
付费起点: —
⚠ ⚠ 仅在 HTTPS / localhost 可用. Chrome / Edge / Safari 16+ 支持; Firefox 部分支持
getUserMedia / Camera API (浏览器内置)
✓ 已配置
实时摄像头流(相机实时翻译)
用途模块: 📡 相机实时翻译 (/camera_translate)
免费额度: 浏览器内置, 无限制
付费起点: —
⚠ ⚠ 仅在 HTTPS / localhost 可用 (浏览器安全策略). 首次使用需用户授权
Perplexity Sonar (已停用 — 备选)
✗ 未配置
⚠ 当前 SEARCH_PROVIDER=gemini, Perplexity 客户端不会被调用
用途模块: 仅在 .env 设置 SEARCH_PROVIDER=perplexity 时才启用
免费额度: Pro 订阅自带 $5/月 API credit
付费起点: Sonar Pro: 输入$3/M / 输出$15/M + 搜索$5/千次
⚠ ✅ 不用配也行 · Gemini 已覆盖所有联网搜索场景 · 当前不计费
OpenAI GPT (二级 fallback · 终极兜底)
✓ 已配置
方案 F 三级 fallback 的最底层 — Gemini 失败 → Claude 失败 → 自动切 OpenAI GPT-5 / GPT-5 Mini
用途模块: 三级 LLM Fallback 终极兜底: chat / chat_vision / chat_json 全镜像、Tier A (重型) → GPT-5、Tier B/C (轻量) → GPT-5 Mini、Vision 兜底 → GPT-5 Vision
免费额度: 无 (按用量付费, 仅 Gemini 和 Claude 双双失败时触发, 极少用)
付费起点: GPT-5: 输入$2/M · 输出$8/M / GPT-5 Mini: 输入$0.3/M · 输出$1.2/M
⚠ ENABLE_OPENAI_FALLBACK=true 时自动启用 · 生产环境实际触发率 <1% · 主要作为保险
🧰 数据流总览 — 哪个模块用哪个API
| 功能模块 | 主要API | 备用降级 | 实时性 |
|---|---|---|---|
| 🎯 行程生成主链路 | |||
| 自然语言解析(NLU) | Claude Haiku 4.5 | OpenAI GPT-5 Mini | — |
| 未收录城市自动注册 | Gemini Flash · 联网搜索 | Claude Haiku / OpenAI | 实时 |
| 智能选城(只说国家时) | Gemini · 联网搜索 + Flash | Claude Haiku / OpenAI | 实时 |
| 多城市访问顺序优化 | 🆓 应用内算法 (2-opt TSP) | — | — |
| 机票深链(4平台) | 🆓 应用内拼接深链 (无 API) | — | 永实时 |
| 💡 机票价格区间分析 | Gemini Pro · 联网实时 | Claude Sonnet / OpenAI | 实时 |
| 📉 价格心愿单/跌价提醒 | Gemini Flash · 后台定时任务 | — | 每 12h |
| 酒店深链(5平台) | 🆓 应用内拼接深链 (无 API) | — | 永实时 |
| 🏨 酒店 AI 推荐叙事 | Gemini Flash | Claude Haiku / OpenAI | — |
| 景点 + 美食(海外) | Google Places (New) | — | 实时 |
| 景点 + 美食(国内) | 高德 Web Service | — | 实时 |
| POI 中文俗称翻译 | Gemini Flash | Claude Haiku | — |
| 🧠 AI 玩法整合(9 天攻略) | Gemini Pro · 联网搜索 | Claude Sonnet / OpenAI | 实时 |
| 📝 POI 真实评论 AI 摘要 | Google Places 评论 + Gemini Flash 摘要 | Claude Haiku | 实时 |
| 📐 多日行程规划(per-day) | Gemini 2.5 Pro · 方案 F 主用 (省 87%) | Claude Sonnet 4.6 / OpenAI GPT-5 | — |
| 🌦 天气预报 | OpenWeatherMap | — | 实时 |
| 🌪 雨天自动重排室内 | Gemini Flash + 天气数据 | Claude Haiku | 实时 |
| 🗺 静态地图嵌入 | Google Static Maps / 高德 | — | — |
| 🚄 城市间转移交通 | Gemini Pro · 联网搜索 | Claude Sonnet | 实时 |
| 🎟️ 本地交通卡/eSIM/WiFi | Gemini Flash · 轻量查询 | Claude Haiku / OpenAI | 实时 |
| 🛠 实用工具 | |||
| ⚠ 行程冲突检测(闭店时段) | 🆓 应用内规则 (查营业时间) | — | 实时 |
| ✨ AI 智能修复冲突建议 | Gemini Flash | Claude Haiku / OpenAI | 实时 |
| 🧠 AI 审视行程(节奏/动线) | Gemini Pro | Claude Sonnet / OpenAI | 实时 |
| 💬 对话式行程编辑 | Gemini Flash · 理解你的口语指令 | Claude Haiku / OpenAI | 实时 |
| 💰 全程费用预估 | Gemini Flash 内置知识 + 国家档案 | — | — |
| 💸 当地物价校准 | Gemini Flash · 轻量查询 | Claude Haiku | 实时 |
| 🛂 签证咨询 + 拒签预估 | Gemini Pro · 联网 (准度要求高) | Claude Sonnet | 实时 |
| 🛐 文化禁忌速查 | Gemini Flash · 轻量查询 | Claude Haiku | 实时 |
| 🎌 节假日/闭店预警 | Gemini Flash · 轻量查询 | Claude Haiku | 实时 |
| 🚨 紧急电话 + 大使馆 | Gemini Flash · 轻量查询 | 🆓 应用内 74 国数据 | 实时 |
| 💊 健康/医疗(时差/海拔/疫苗) | Gemini Flash · 联网搜索 | 🆓 应用内海拔数据 | 实时 |
| 🎢 Disney/Universal 实时排队 | 🆓 queue-times.com (公开 API, 不扣费) | — | 实时 |
| 📐 城市间问路卡片 | Gemini Flash · 双语本地化翻译 | Claude Haiku | — |
| 🧳 行李清单 PDF | Gemini Flash | Claude Sonnet / OpenAI | — |
| 📅 .ics 日历导出 | 🆓 应用内算法 (无 API) | — | — |
| 📷 多媒体(独立工具) | |||
| 📸 拍照菜单/路标翻译 | Gemini Flash Vision | Claude Vision / OpenAI Vision | 实时 |
| 🎤 同声实时翻译 (文字) | Gemini Flash · 翻译引擎 | Claude Haiku / OpenAI | 实时 |
| ☁️ 云端语音识别 ASR | Gemini Native Audio | OpenAI Whisper | 实时 |
| ✨ 写游记(图片→文案) | Gemini Flash Vision | Claude Vision | 实时 |
| 📖 行程纪念册 PDF | Gemini Flash Vision · 自动读取照片拍摄时间和地点 | Claude Vision | — |
| 💸 实际花费 OCR | Claude Sonnet Vision · OCR 高准度要求 | OpenAI Vision / Gemini Pro Vision | 实时 |
| 🗂 数据 + 导出 | |||
| 💱 汇率换算 | 🆓 open.er-api.com (公开 API, 不扣费) | — | 日更 |
| 🗺 离线地图 ZIP 包 | OpenStreetMap 地图瓦片 + Google Static Map | — | — |
| 🔗 行程只读分享 | 🆓 应用内浏览 (无 API) | — | — |
| ↔ 双行程对比 | 🆓 应用内对比 (无 API) | — | — |
| 🎓 个性化学习 | Gemini Flash · 从你的历史 trip 学习偏好 | Claude Haiku | 每周 |
| 📊 数据校准 cron | Gemini Flash · 每月自动更新交通卡/急救数据 | Claude Haiku | 每月 |
| 📕 PDF 行程导出 | 🆓 应用内 PDF 库 (reportlab) | — | — |
| 🔔 通知中心(天气警报等) | 🆓 应用内数据库 (SQLite) | — | — |
共 40+ 个功能模块
🎯 我的偏好(AI 学习)
基于你之前 10 个项目的编辑记录, AI 自动学到的偏好;生成新行程时自动注入 prompt加载中…
📋 功能 → API 依赖速查
每个功能用了什么外部服务?要不要单独配?| 功能 | 用到的 API | 你需要做 |
|---|---|---|
| ✈ 一句话生成行程 | Google Gemini (主) · Anthropic Claude (fallback) · OpenAI (兜底) · Google Maps · 高德 | ✅ 5 个核心 key 已配 |
| 🌐 签证 / 物价 / 禁忌 / 节假日 / 交通卡 / 紧急 / 价格洞察 | Gemini Pro/Flash · 联网搜索 (Claude/OpenAI fallback) | ✅ 已配 |
| 📝 真实评论 AI 摘要 (POI 卡 📝 按钮) | Google Places API (New) + Gemini Flash 摘要 | ⚠ Cloud Console 启用 "Places API (New)" 服务 📌 仅国外 POI 可用(国内是高德数据) |
| 🎢 POI 实时排队 | queue-times.com 公开 API | ✅ 无需 key |
| 🎤 同声实时翻译 (文字) | 浏览器语音识别 + Gemini Flash 翻译 (Claude/OpenAI fallback) | ✅ 无需新 key ⚠ 浏览器需 HTTPS / localhost 🎁 每天免费 50/200/1000 次 (游客/会员/VIP), 会员/VIP 用完 ₪0.01/次 续用 |
| ☁️ 云端 ASR (国内 Android/微信) | Gemini Native Audio (OpenAI Whisper fallback) | ✅ 用现有 key 🎁 每天免费 20/100/500 次 (游客/会员/VIP), 会员/VIP 用完 ₪0.02/次 续用 |
| 📸 拍照上传翻译 | Gemini Flash Vision (Claude Vision fallback) | ✅ 无需新 key 🎁 每天免费 5/30/100 次 (游客/会员/VIP), 会员/VIP 用完 ₪0.05/次 续用 |
| 📖 行程纪念册 PDF | Gemini Flash Vision · 自动读取照片拍摄时间和地点 | ✅ 无需新 key 📌 用户扣费 ₪3/次 (API 真实 ₪0.26, 11×markup) |
| 💊 健康医疗 / 🛐 文化禁忌 / 🎯 拒签预估 | Gemini Flash · 联网搜索 + 内置 74 国知识库 | ✅ 已配 |
| 🗺 离线地图 ZIP | OpenStreetMap tiles(浏览器在线时)+ Google Static Map(打包时) | ✅ 无需新 key |
| 📅 .ics 日历导出 / 🚨 紧急电话 | 🆓 应用内算法 (无 API) / 知识库 | ✅ 无需 key |
| 🧳 行李清单 | Gemini Flash (Claude/OpenAI fallback) | ✅ 已配 |
| 🌪 天气警报 / 重排 | OpenWeatherMap | ✅ 已配 |
| 🎨 写游记 (长文) | Gemini Flash (Claude/OpenAI fallback) | ✅ 已配 |
| 💸 实际花费 OCR | Claude Sonnet Vision (高准度要求) | ✅ 用现有 Claude key |
| 🤖 三级 LLM Fallback | Gemini → Claude → OpenAI (任一失败自动切下一档) | ✅ 已配 |