MG-04-016 图片采购报价接口

入口 /supplies/image 每 Key 的硬币图标。使用现行独立管理员会话、同源/CSRF/本地客户端保护。浏览器 /backend/image-channels/{id}/pricing 转发到 /admin/v1/image-channels/{id}/pricing，不可传递 Provider Key 或任意代理路径。

配置与读取

GET 返回 version/config/quote/snapshot_id/stale/supply_versions/applicable/apply_note。PUT 必须 If-Match 渠道版本；JSON 是 base_url/recharge_cny/credited_usd/key_discount/group 五个字符串。facade 接受额外数字 version 并转为 If-Match。人民币/美元数值必须正十进制、最多18位小数，留空表示未知；额外Key折扣 (0,1]，默认1表示无额外折扣，不重复填写公开分组倍率。配置仅写 channels.connection_settings.image_pricing 并递增渠道版本、审计；不触碰 Supply 启停/验证、凭据、执行URL和标准参数。

报价地址是独立HTTPS origin，无用户信息、查询、片段、子路径。默认沿用执行origin，tuba 的 https://us-api.tuba.ink 默认报价origin https://api.tuba.ink。不会因此改变执行地址。

POST /pull，空对象+If-Match。公开 GET /api/pricing、/api/status，不带Key。使用现行DNS重绑定/私网防护的公共HTTP客户端；禁重定向，单响应2MiB，单请求30秒，总65秒。仅保存已配置精确上游名对应的明细，别名以现行映射解析，不模糊匹配。失败不删除或覆盖旧观察。

• new-api model_price 是美元额度价格，不因 quota_display_type=CNY 直接当人民币。
• CNY成本 = model_price × group_ratio × recharge_cny ÷ credited_usd × key_discount。
• token 基价为 model_ratio × 2 美元/百万输入token；输出、缓存、图片输入倍率分别保留，不能当固定按张价。只展示公开存在的维度，不预测一次生成消耗或完整账单。
• Origin media_aggregate_prices 保留 group/media_type/operation/spec；其中 price_cny 已含分组倍率，不能重复相乘。先按该站 /api/status.usd_exchange_rate 换回美元额度，再用实际充值比例折算；缺少站点换算信息则待核对。该字段不是公网外汇价格。
• 采用十进制定点运算、最终除法18位小数；正报价折算下溢不允许当免费。原币报价、倍率、来源、观察时间和精确单位一起保存。
• 未指定Key分组时先展示各公开分组的精确报价，输入分组可在浏览器内筛选；未保存/未确认分组不会被当成Key实际成本。
• 分组必须是模型明确支持的精确名字；未知分组倍率不默认1。未输入比例、缺型号、未知模式或不完整价格保持待核对。

来源协议独立实现，未复制new-api代码：公开信息API、价格单位实现。

快照与成本应用

复用 catalog_discovery_snapshots/entries 的 prices 类型，adapter_profile 为 new-api-public-pricing-v1。快照带 source、observed_at、精确行，以及执行origin/协议/凭据版本/实际型号/报价配置的fingerprint。GET无写入；配置变化旧报价展示为过期、禁止应用。普通重命名不抹除报价。

POST /apply 需要 If-Match 和 {snapshot_id,supply_versions:{UUID:version},charge_on:"success"|"submit"}。收费时点由管理员明确选择，不能由公开定价接口猜测。服务端重新取得原生快照、计算适用条件，不接受浏览器金额。

当前图片系列按Key共用采购规则。只有该Key所有配置精确上游型号都有单一、同价、明确按次的已折算报价，才允许批量应用到匹配的已有原生Supply。无Supply时先在图片调度添加Key；不同价、token、规格/操作档位和未知模式保留明细，不压平覆盖系列规则。该限制在UI明确显示。

应用按channel→Supply ID顺序持锁，并检查全部Supply版本，整批复用 addCostRuleTx，Source=provider_api、CNY、per_request。元数据记 image_cost_known、image_cost_unit=per_request、image_pricing_snapshot_id；来源/观察时刻可追溯。成本变更按既有不变量使相关Supply停用并待重新验证，绝不隐式启用；任何CAS/审计失败回滚整批。不创建Supply、不改排序、标准模型或执行协议。

实际充值比例由用户提供。空白配置允许拉取/持久化公开报价，不能凭示例值写入真实采购成本。无收费生成、生产切流或业务库迁移。

MG-IMAGE-22 弹窗流程与型号价格

保存操作按原契约先PUT配置，成功后使用响应的新渠道版本自动POST /pull。两步保持显式结果：配置失败不拉取、保留草稿；配置成功而拉取失败保留已保存版本及过期报价，可点击“更新报价”仅重试拉取。刷新折算结果不执行 /apply，原生采购规则与供给状态只有明确应用时才变更。

应用按钮旁通过可访问描述列出缺少/非法的实付人民币、到账美元额度、Key折扣、上游分组、未保存配置、缺失/过期报价、收费时点与服务端不适用原因；在途及归档同样有说明，不只显示一个灰按钮。

渠道型号摘要展开后才GET当前Key的报价；按标准→上游精确映射匹配行，显示公开/折算报价与单位、分组、规格/操作。过期报价只显示公开原币价及过期标记，不作为当前人民币成本；缺失/失败保持明确未知，可重试，GET不拉取上游或写规则。保存/刷新/应用后打开的型号区重读报价；点击标准型号进入其精确上游报价视图，可切回全部型号。局部查看不改变应用范围，界面明确应用覆盖当前Key的全部匹配型号。