给 AI

问答

数据接口价格里的“按条计费”和“单次最高收费”是什么意思?

简短回答

按条计费是按一次调用返回的结果条数收钱;单次最高收费把一次调用的费用封顶在一整页。okdata 里按条计费的接口是公众号搜索:每返回一个公众号 $0.058,最少算一条,单次最多 $0.58。其他接口都按次计费,价格本身就是最高收费。

数据接口的计价单位大体两种。按次计费:一次请求不管返回多少都是同一个价。按条计费:响应里每有一条结果就收一份钱,所以找到三条的请求比找到十条的便宜。X 官方 API 就是后一种,它的按用量计费页面写的是按返回的帖子或用户计费。按条计费必须有个上限,不然调用之前你没法知道这次要花多少钱。这个上限就是单次最高收费。

okdata 怎么用这两种计价

按次计费的接口(几乎全部) 按条计费:公众号搜索
价格 每次调用,比如抖音搜索一页 $0.02 每返回一个公众号 $0.058
最少计几条 不适用 1 条,一个都没搜到也算 1 条
单次最高收费 等于价格 $0.58,即一整页 10 个公众号
翻页 每页一次调用 每页照样按返回的公众号数计费

每个接口的页面都会在价格旁边标明计价单位。目前接口目录里按条计费的只有公众号搜索这一个。

算几笔账

搜索 返回的公众号数 收费
query=36氪,第一页是满的 10 $0.58
一个精确的公众号名,匹配到 3 个 3 3 × $0.058
一个搜不到的名字 0 $0.058(最少算 1 条)
20 个品牌名,按最坏情况做预算 最多 200 最多 $11.60

最高收费和余额

单次最高收费是一次调用可能花掉的钱,所以余额要先够付它。不够的时候,按次计费的接口会返回 insufficient_balance,不扣费。公众号搜索的处理宽松一些:余额不够一整页时,第一页按余额能付的条数返回,这一页缩短了,也就没有下一页。充值之后就恢复整页返回。

示例

直接从响应里看这次调用实际扣了多少:

curl -s -G "https://api.okdata.online/v1/wechat_mp/accounts/search" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'query=36氪' \
  --data-urlencode 'fields=id,name' \
  | jq '{charged: .meta.billing.amount, accounts: (.data.items | length), balance: .meta.billing.balance_after}'

给一批任务做预算,用调用次数乘以单次最高收费,这就是这批任务最多会花的钱。实际账单通常更低,因为按精确名称搜,很少能填满一整页。

限制

  • 请求到了数据源的调用,返回为空、not_found、数据源出错或超时,都照常计费,按条计费的接口算一条,也就是 $0.058。参数错误这类还没请求数据源就被拦下的不扣费。
  • 因为最少算一条,100 个名字全部搜不到,也要付 100 × $0.058。搜之前先把名单清洗一遍。
  • 24 小时内用同一个 Idempotency-Key 重试,返回的是存好的结果,不会再扣一次。

想把其他供应商的各种计价单位换算成可比的数字,见按次、按条、按积分报价的数据接口怎么比价。要找公众号本身,见怎么查公众号的 biz 和原始 ID。

资料来源

  1. X API 按用量计费:按返回的资源数收费docs.x.com · 读取于

这个问题出现过的地方(读取于 2026-11-12)

更新于

接上一次,以后直接问 AI。

新 key 自带 $0.10 试用额度。贴一句话,就能接进你的智能体。

免费开始
一句话接进你的 AI

把这句话发给你的智能体

读一下 https://okdata.online/zh/agents.md,帮我把 okdata 配好;我的 key 在环境变量 OKDATA_API_KEY 里。

Claude Code、Cursor、Codex 等能打开网址的智能体,读完会自己配好。

MCP 地址https://api.okdata.online/mcp