Tare API (2026-08-22.4)

请求体原样透传：未识别的字段照发给上游，这是 cache_control、reasoning、 plugins 这类字段能工作的原因。我们只改动四处：模型名换成上游认的、stream 固定为本次尝试的模式、流式强制 stream_options.include_usage=true、剥除归因字段。

⚠️ usage.cost 是「花了你多少」。 走平台渠道（token 的钱由我们垫）时，回包中 不含 usage.cost_details —— 那一格是上游向我们收取的金额。BYOK 下保留： 那是你自己上游账单上的钱，也正是成本归因需要的数据。 （2026-08-22 之前两种模式都返回了；已修。） 算不出来时 cost 整格不出现，而不是 0 —— 「该模型尚未定价」也算算不出来。

⚠️ 两种上游方言的流式末帧形状不一致（OpenAI 兼容是 choices: []，Anthropic 是 choices 有一项而 delta 为空）。按帧渲染时判据写成「choices 为空 或 delta 无内容 → 跳过渲染，只取 usage」。

请求体原样透传，回包是上游原文加一格 usage.cost。

⚠️ 模型名不做映射。 chat 那边写的是我们这边的模型名（取自 GET /models）， 这里写的是上游自己的名字（text-embedding-3-small 这一类）—— embeddings 不走模型路由表，所以没有那层映射，回包里的模型名同样不改写。

⚠️ 打到哪条渠道：你自己的渠道优先（显式配的 > 按方言推出来的）， 都没有才走平台那条被指定的渠道。 两者的计费不同（自己的渠道只记账，平台渠道按售价扣余额），所以不会在两者 之间自动故障转移 —— 一次静默的回退等于在你没同意的情况下开始花钱。

没有流式。gen- 编号走响应头，用法和 chat 一致。

完整明文只在创建时返回一次。带 external_id 时同一个编号重复创建是幂等的： 返回已存在的那把，HTTP 状态码是 200 而不是 201。

⚠️ 幂等重放只在创建后 5 分钟内能拿回明文。超过窗口 key 是 null， 并附 key_unavailable_reason（枚举值）和 key_unavailable_message（文案会变）。

游标翻页。⚠️ 游标是 id 不是 offset：翻页途中若有新 key 创建，offset 会让某一把被 跳过或重复出现。账号下的子钥总数不设上限，单次返回的行数有上限。

⚠️ 解封用 {"disabled": false}，不要用同一个 external_id 再开一把： external_id 的唯一性包含已停用的 key，一个编号永久对应一把 key。

有了它就不必在你那边维护一张 external_id → hash 的映射表。

带上推理 key，目录里就包含你自己配的模型：你在自己渠道上配的那些 ∪ 平台的那些， 同名时以你自己那条为准 —— 和真正调用时的路由口径完全一致。

凭据是可选的：不带任何请求头时返回平台目录（客户端确实这么用，这条路一直保留）。 但带了就必须是真的 —— 无效或过期的 key 返回 401，不会静默给你一份 「少了你自己模型」的目录。

推理 key 和母钥都可以。母钥没有绑 Router，它拿到的是账号默认那套路由的目录； 要看某一把绑了别的 Router 的子钥能用什么，就拿那把子钥来调。 对账 key 返回 403（它碰不到模型这一片）。

⚠️ 你自己渠道上的模型，pricing.prompt / completion 是 0：那些 token 你直接付给 上游，不经我们的价目表。真实成本读回包的 usage.cost。

⚠️ 404 是正常路径，不是错误：用量记录在响应之后才写入。非流式通常 1 秒内可查， 流式以流结束为准；中途断开的流需事后向上游回查，可能到分钟级。 请把 404 当作「稍后再试」，退避几秒后重试。

这一组是留存开关本身（控制台上叫 Call Traces）。默认不存：关闭时 request_content / response_content 两列为空 —— 是没有存，不是存了不给看。

⚠️ 没有「永久授权」这个选项，时长 1 小时 – 30 天：无时限的授权会在排查结束后 一直留存。授权期内每次读取都会记录审计。

到期的授权自动失效，无需处理。

接入时从这里开始，否则「空数组」与「鉴权失败」无法区分。

读取夜间汇总表，当天部分为实时计算。⚠️ 单次查询窗口上限 100 天，超出返回 明确的错误，不做静默截断。

⚠️ 账号级：同一账号下所有 key 共享一个钱包。要限制单把 key 的消费用母钥的 limit，那是另一套机制。

⚠️ 已锁定的账单不会被改写。 迟到的更正计入下一期，该行会注明来自哪个月。 如果你的 ERP 预期「更正到达后上个月的数字会变」，那不会发生。