用途：跨 27 个里程计划（含 2026 年 4 月新增的 Spirit Free Spirit 与 Frontier Miles）搜索缓存与实时奖励机票余票，比较不同计划的里程成本并获取预订链接。
认证与限制：在 .env 中设置 SEATS_AERO_API_KEY，从 Settings > API 获取，需 Pro 账户；请求使用 Partner-Authorization 头。Pro 用户每日 1,000 次 API 调用，仅限非商业用途。API 基址为 https://seats.aero/partnerapi。
主要端点：缓存搜索 /search（按机场与日期，支持 cabins、sources、carriers、only_direct_flights、order_by=lowest_mileage、include_trips、take、skip、cursor 等参数）；行程详情 /trips/{id}（含分段、预订链接、坐标与税费，税费以分为单位）；批量可用性 /availability（按单个计划与地区检索）；路由列表 /routes；实时搜索 /live（任意城市对，响应 5-15 秒，需商业协议，Pro 用户不可用，返回 ID 非真实且不可用于其他接口）。
概念：Saver 为固定价格，通常仅此类可经伙伴计划预订；Dynamic 按需定价，默认会按各计划每小时阈值过滤掉过高的动态价格，可用 include_filtered、disable_filters 或 show_dynamic_pricing 显示。需警惕幽灵余票（缓存过期、同步延迟、伙伴数据错误），转账积分前应在航司官网核实并对比同联盟计划。部分外国计划可能要求本地税号或支付方式，可作为可用性信号。
用法建议：搜索结果摘要仅显示最便宜行程，务必拉取行程详情，尤其涉及 2 名以上旅客时；检查 ComputedLastSeen 判断数据新鲜度；计算中转停留时长，超过 3 小时应明确标注并同时给出更优选项。分页用 skip 与 cursor，cursor 按不透明时间戳处理并按 ID 去重。
限制：实时搜索不可用于 Pro；结果可能为空的原因包括未放出 Saver 票、精英/会籍限制、航线未被监控、超出放票窗口或已被预订。资料未提供定价与更多计费细节。