配额、计费与限流
按调用扣「API 点」
每次成功调用按端点扣除固定 API 点。参数错误(400)、档位拦截(403)、限流(429)都在扣费之前返回,不扣点;调用彻底失败时已扣的点会退回。
| 端点 | 消耗(API 点) | 可用档位 |
|---|---|---|
/v1/text-search | 20 | 全部(含免费版);伙伴国辖区(DE/IT/ES/TR/BX)需付费 API 套餐,同为 20 |
/v1/graphic | 30 | 全部(含免费版) |
/v1/image-search | 30 | 全部(含免费版) |
/v1/advice | 20 | 全部(含免费版) |
/v1/batch-screen | 20 / 条(按有效条数,单次 ≤ 2,000 条) | 全部(含免费版) |
/v1/customs/risk | 2 | 全部(含免费版) |
/v1/policy/query | 3 | 全部(含免费版) |
/v1/epo-search | 2 | 全部(含免费版) |
/v1/account/credits | 免费 | 全部 |
/v1/listing/fix | 5 | 需付费 API 套餐 |
| 合规检测系列 | 5–75,按端点(见合规检测) | 需付费 API 套餐(政策特征管理免费) |
月度点数与档位
所有 API 套餐都能调用全部自有接口,套餐之间只差月度点数、每账户限速与 Key 数。
| 档位 | 月点数 | 可用接口 | 每账户限速 | Key 数 |
|---|---|---|---|---|
| 免费版 · ¥0 | 1,000 点 | 全部自有接口:文本(本地辖区)、图形、以图搜图、批量、结论、海关、政策、EPO、MCP;第三方合规(专利/版权/安全词/政策图文)、伙伴国辖区、Listing 改写需付费套餐 | 1 次/秒,突发 10 | 3 把 |
| 入门版 · ¥999/月 | 20,000 点 | 全部接口 | 2 次/秒,突发 30 | 5 把 |
| 成长版 · ¥2,999/月 | 60,000 点 | 全部接口 | 5 次/秒,突发 45 | 10 把 |
| 企业版 · ¥9,999/月 | 200,000 点 | 全部接口 | 10 次/秒,突发 60 | 20 把 |
- 限速按账户计:同一账户的所有 API Key、网页登录态调用与 MCP 共用同一个令牌桶,多开 Key 不叠加速率;超出返回
429 rate_limited。 - 出口 IP 上限:同一出口 IP 的全部请求合计不超过 20 次/秒(与档位无关)。
- Key 数不含 MCP 授权自动签发的 Key。
- 所有档位均为邮件支持。
API 套餐独立计量,不占用 One1 应用内的积分。购买见开放平台或开发者控制台。
第三方数据源接口的扣点规则
合规检测系列、伙伴国辖区(DE/IT/ES/TR/BX)的文本检索、Listing 改写调用第三方数据源 / 大模型,有真实外部成本:
- 免费版不可用:调用返回
403 paid_plan_required,未扣点;购买任一 API 套餐即可使用。 - 只扣套餐月度点:免费额度与赠送点不可用于这些接口。套餐月度点用完时返回
402 cash_quota_exhausted(「赠送点不可用于第三方数据源接口，本月套餐点已用完」);其余自有接口仍可继续使用赠送点。
配额响应头
| 响应头 | 说明 |
|---|---|
X-Request-Id | 所有响应(含错误)都带:本次请求的追踪 ID,与 body 顶层 request_id 同值;调用方在请求头自带时原样回显 |
X-Quota-Remaining | 成功响应带:本月剩余 API 点,含赠送点;第三方数据源接口只可用套餐月度点,余额以 /v1/account/credits 的 breakdown 为准(monthly_quota − used)。/v1/account/credits 与合规检测系列端点的该头 = body 的 balance;无限量账户不发此头 |
X-Charged | 成功响应带:本次调用实际扣除的 API 点(合规检测系列端点 = body 的 cost;未扣费路径为 0) |
Retry-After | 仅限流与服务暂不可用时带,单位秒:429 rate_limited 为 1;503 busy 为 5;503 upstream_error / data_unavailable / country_unavailable 为 2。请按其退避后重试 |
点数用尽返回 402 quota_exceeded(需升级 / 续费 API 套餐);超出每账户限速返回 429 rate_limited(带 Retry-After: 1,错误体 error.retryable: true)。建议读取 X-Quota-Remaining 主动降速;调用第三方数据源接口前请以 /v1/account/credits 的 breakdown 预检,避免余额显示为正仍返回 402 cash_quota_exhausted。合规检测系列的扣点见成功响应体中的 cost 字段(与 X-Charged 同值)。响应体与响应头都不含数据新鲜度字段,各辖区数据截止日用免费的 GET https://one1.cn/api/coverage?country=XX 查询。