搜配云API怎么计费？点数、扣点规则与成本控制方法

搜配云 API 采用点数制计费：1 元 = 100 点，每个接口有明确的扣点标准，且精准接口在只返回候选车型时免费。费用高低不只取决于调用了多少次，更取决于用的是哪个接口、一次查询覆盖了多少个品类。首次开通会赠送 100 次调用额度用于开发测试，之后可以在线充值或联系商务充值。下面把扣点口径、免费额度、版本差异与成本控制逐条讲清楚。

点数制怎么理解

点数可以理解为一种预付费的计量单位：调用量、扣点标准和余额都在同一个后台视图里，预算和成本都是可加总的。

需要先分清两个概念：

• 调用次数：发出了多少次请求，是过程指标；
• 点数消耗：实际扣掉了多少点，才是成本指标。

两者在多数情况下不同步：有的接口固定扣点，有的按品类数分档，有的只在返回候选车型时不扣点。做成本估算要按点数核算，不能简单用"次数 × 单价"来推。

扣点规则：按接口与品类分档

这张表有两处最容易被忽略。

第一处是候选车型免费。当精准接口没有直接命中唯一车型、只返回候选车型列表时，这次调用不扣点。这相当于一个免费的筛选环节：先用 VIN 或车型信息拿到候选车型，确认后再发起正式的精准查询，把点数花在确定的车型上。

第二处是品类数量决定档位。同样是用 VIN 查产品，覆盖 1-10 个品类扣 5 点，覆盖 11-20 个品类扣 10 点。所以"一次请求查全部品类"和"只查本次业务真正需要的品类"是两种完全不同的成本结构，范围收敛得越准，单位点数办成的事越多。

免费额度怎么用

首次开通赠送 100 次调用额度，定位是开发测试，不是试运营。建议用真实 VIN 跑通"车型解析 → 配件查询"主链路，确认字段口径与业务预期一致；覆盖 VIN 图片识别、车牌识别等不同输入，把异常提前暴露出来；多品类查询与候选车型查询各跑一遍，先看清自己业务会落在哪个扣点档位；并在联调阶段就把日志埋好，让每次调用对应到具体业务单号，后面才能做归因。

接口是标准 HTTPS JSON / multipart 形态，与语言无关，文档提供 curl、Python、JavaScript、Java、PHP 示例。接入流程可参考搜配云API接入指南。

充值与版本怎么选

基础版、高级版、专业版均免费开通，区别在日调用上限与并发能力，开通时的起充金额不同。

选版本的依据是业务的日查询量与并发峰值，不是充得越多越好。前台录单、门店自助查件这类实时场景看并发；批量补数据、夜间同步这类离线任务看日调用上限。

调用次数不够时有两条路：在线充值，或联系商务充值。前者适合日常补量，后者适合已明确要长期放量的业务。

成本控制方法

点数消耗能被工程手段优化，几条经验最实用：

• 缓存车型解析结果：以 VIN 为键缓存解析结果，重复查询直接命中本地缓存，这是省点数最直接的一条；
• 避免重复解析：录单、报价、查库存各调一次解析，是最常见的浪费来源，应统一到一处解析后共享结果；
• 用候选车型免费接口做筛选：需要用户确认车型时，先走只返回候选车型的调用，确认后再查产品，不要拿付费查询当试探手段；
• 收敛查询品类：只查本次业务需要的品类，避免无差别全品类拉取；
• 按业务分密钥：为不同业务、不同环境创建独立密钥，方便把消耗归到具体来源；
• 用日志对账：把 VIN、解析结果、查询品类与最终件号一并落日志，便于回溯和与后台消耗记录核对。

与后台数据打通时，这些做法可以和汽配ERP对接配件数据的流程一起考虑，避免重复实现。

监控与对账怎么做

管理后台提供调用量监控与详细日志，可以看到每日消耗、剩余点数，以及各接口的调用情况。建议形成固定的对账节奏：每日核对消耗与当日业务单据量是否匹配；每周看各接口的调用分布，判断是否有点数花在低价值的调用上；上线或改版后重点核对，新增的调用点往往正是消耗突增的原因。

对账的价值不在数字本身，而在于发现"谁在扣点"：消耗异常时能定位到具体接口与密钥，问题很快就能收敛。

密钥管理与安全

密钥直接对应点数消耗，安全上按这几条执行：

• 专钥专用：为不同业务创建独立密钥，既便于归因，也避免一处泄露影响全部业务；
• 密钥不落前端：只放在服务端，不写进小程序、H5 或客户端代码；
• 可止损：密钥支持立即重置或禁用，泄露或人员变动时能马上切断；
• 分类存放：测试与生产密钥分开，避免调试流量混进生产消耗。

密钥管理不到位，损失不只是数据泄露，还包括无法解释的点数消耗。

常见成本误区

把"调用次数"和"点数"混为一谈。 同一批业务量，因为接口选择与品类范围不同，扣点可以差出数倍。预算要按点数核算。

不做缓存导致重复扣点。 一次解析结果能被多个环节复用，如果不缓存、每个环节各调一次，等于为同一台车反复付费。高频业务里这是最容易失控的一项。

多业务共用一个密钥。 消耗混在一张流水里，成本无法归因到业务线，异常消耗也定位不到来源。分密钥成本极低，收益是账目清晰。

把免费接口当付费接口用。 需要用户确认车型的场景，本可以先走只返回候选车型的调用，直接上精准查询则会产生不必要的扣点。

沿用旧口径做估算。 计费规则以官方最新口径为准，不要用某篇文章里的经验公式推算单价，两者很容易对不上。

小结

搜配云 API 的计费逻辑是：1 元 = 100 点，查询品牌品类接口每次扣 100 点，VIN 查产品按品类数分档（1-10 个品类扣 5 点，11-20 个品类扣 10 点），精准接口在只返回候选车型时免费。首次开通赠送 100 次调用额度，基础版、高级版、专业版均免费开通，分别充值 1000、2000、10000 起，区别在日调用上限与并发能力。控制成本的关键动作是缓存解析结果、避免重复解析、收敛查询范围、按业务分密钥、用日志对账。能力说明与计费口径见搜配云API，具体接口细节以官方接口文档为准。