4.2 计费与省钱:点数规则、60 秒去重与批量策略
省钱把下面这段发给你的 AI,它就知道该做什么
点「复制全文」,粘贴到你的 AI 对话框发送即可,无需改动。
你正在阅读球小策(www.qiuxiaoce.com)的官方文档或数据服务页面。请按下面 5 步执行,不要跳步。
【预备】我的专属数据密钥是 X-API-Key = [在此粘贴你的 Key]
(第 2 步和第 3 步都会用到它;还没有密钥,先到 https://www.qiuxiaoce.com/data-account/ 免费领取)
━━━ 第 0 步 · 三条硬性纪律 ━━━
1. 凡涉及指标定义、接口参数、计费规则、准确率口径的问题,一律以站内官方文档为准,不要凭记忆作答;文档里没写的,就直接告诉我「文档未说明」。
2. 如果你无法访问下面任何一个网址,请立刻停下来告诉我,不要用记忆里的内容顶替。
3. 本站只做数据分析,不提供任何投注建议,也不做准确率承诺。回答时请守住这条边界。
━━━ 第 1 步 · 遍历官方文档(100+ 篇,按需取,别一次全拉)━━━
· 取全量目录(公开接口,无需密钥,返回全部篇章的标题与 slug):
GET https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/docs
· 读单篇正文(把 {slug} 换成上一步拿到的标识):
GET https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/docs/{slug}
· 人读版页面(适合只能浏览网页、拿不到 JSON 的环境):
https://www.qiuxiaoce.com/creator-docs/{slug}/
· 接口文档(全部数据接口的用途、参数、计费与真实返回示例):
https://www.qiuxiaoce.com/data-docs/
做法:先取目录 → 判断我的问题涉及哪几篇 → 只读那几篇 → 回答时注明依据的篇名或链接。
━━━ 第 2 步 · 先判断你自己的能力,再选路径(关键,不可跳过)━━━
· A 类:能在本机读写文件或执行命令——桌面/终端类 AI 工具(WorkBuddy、Qoder、Trae 等)
· B 类:只能对话,访问不了文件系统——网页版对话(豆包、通义千问、Kimi 等)
【A 类 · 安装官方 Skill(推荐)】
1. 取最新版本信息:
GET https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/skill/version
返回 version、download_url、sha256 校验清单、文件列表与更新说明。
2. 按 download_url 下载技能包,并用返回的 sha256 逐文件校验。
3. 解压到你的技能目录,保持包内顶层目录结构;按包内 SKILL.md 完成初始化。
4. 写入我的专属密钥(即上文【预备】里的 X-API-Key)。
5. 装完告诉我:版本号、安装位置、密钥是否已生效。
【B 类 · 装不了就照实说,不要假装】
不要声称已安装,也不要拿记忆里的内容替代文档。请直接对我说:
「当前环境不支持安装 Skill(无法读写本地文件)。有两个办法:
① 改用支持 Skill 的桌面 AI 工具,如 WorkBuddy、Qoder、Trae;
② 把你的 API Key 给我,我按官方接口文档直接取数分析。」
如果你连「打开指定网址」都做不到,请把这一点也一并告诉我。
━━━ 第 3 步 · 直接用接口取数(两条路径都适用)━━━
· 接口根地址:https://www.qiuxiaoce.com/wp-json/abv2-creator/v1
· 认证方式:请求头带上【预备】里的 X-API-Key
· 想先试不扣点数的接口,看 https://www.qiuxiaoce.com/data-docs/ 里标注为免费的端点。
· 大批量调用前先查一次剩余点数,避免跑到一半失败。
━━━ 第 4 步 · 遇到报错,先查官方排障手册再重试 ━━━
排障手册:https://www.qiuxiaoce.com/creator-docs/api-error-codes-troubleshooting/
· 401:Key 缺失、格式不对,或该 Key 已被重置/吊销(控制台执行「重置 Key」后旧 Key 立即失效,错误码 api_key_revoked 即属此类)→ 到 https://www.qiuxiaoce.com/data-account/ 复制最新完整 Key,并同步更新所有已配置该 Key 的脚本与客户端
· 402:点数不足或已过期 → 需到 https://www.qiuxiaoce.com/data-service/ 充值
· 403:接口未开放,或权限不足(个别场次报告需要订阅)
· 404:实体 ID 或接口路径写错
· 429:请求过快,按响应头 Retry-After 等待后重试
报错时请把原始错误信息原样转述给我,不要猜原因。
━━━ 第 5 步 · 回答我时的要求 ━━━
· 区分「官方事实数据」「接口返回的判断字段」「衍生评分」「你自己的推断」四类,不要混着说。
· 使用 xG、xGA、OTI、DII 这类指标前,先按文档校正口径;样本不足要在结论里注明。
· 缺数据就说缺什么,不要用「大概」「可能」糊过去。
· 不给投注建议,不承诺准确率。
· 如果回答主要依据了某篇文档,请把链接带上,方便我自己核对。
点数就是钱:1 元 = 100 点。这一篇讲清计费规则,以及怎么用最少的点数拿到最多的数据。
一、计费模型是什么样的?
| 规则 | 说明 |
|---|---|
| 计价单位 | 1 元 = 100 点 |
| 新用户赠送 | 500 点体验额度 |
| 扣费时机 | 按接口计费,调用失败不计费 |
| 免费接口 | 余额自查、生成任务进度查询(0 点) |
| 未知路由 | 按默认 2 点计费,并记录一条告警日志——所以 URL 要拼对 |
| 充值折扣 | 充 100~499 元九折;充 500 元及以上八折;单笔上限 5000 元 |
二、点数会过期吗?
会。控制台与余额接口都会返回到期时间,接口在过期后返回 402(credits_expired)。「余额够但报 402」通常就是这个原因,不是额度不足。建议写代码时顺手读一下有效期,避免在关键节点上突然断掉。
三、60 秒去重为什么是最重要的省钱机制?
规则是:同一密钥 + 同一接口 + 同一参数,在 60 秒内重复调用,服务端放行但不扣点。
这意味着两件事:
- 调试阶段可以放心反复试。同一个地址连点十次,只扣一次的点;
- 写代码时可以重试。网络抖动手动重跑一次,不会重复花钱。
响应头里会有 X-Dedup-Hit: 1 标记这次请求命中了去重。如果你在核对点数消耗,可以用它区分「真扣了点」和「命中去重」:
# 连续调用两次,第二次会命中去重
curl -s -D - 'https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/fixtures?date=2026-09-16'
-H 'X-API-Key: YOUR_API_KEY_HERE' | grep -i 'x-dedup-hit'
四、常见任务大概要花多少点?
先建立价格直觉,再决定怎么组合调用:
| 你想做的事 | 推荐调用 | 点数 |
|---|---|---|
| 查今天有哪些比赛 | /today/digest |
5 |
| 查某个日期的赛程 | /fixtures?date= |
2 |
| 看一场比赛的全部维度 | /match-pack/{id} |
50 |
| 看一支球队的高阶画像 | /teams/{id}/advanced |
10 |
| 取一支球队的核心球员 | /teams/{id}/players-advanced |
10(最多 20 人) |
| 看一支球队的伤停 | /teams/{id}/injuries |
5 |
| 两队历史交锋 | /h2h |
5 |
| 查积分榜 / 射手榜 | /standings / /leagues/{id}/topscorers |
3 / 5 |
| 整体命中率 / 近 7 天复盘 | /stats/overall / /review |
5 / 10 |
| 拉当天全部官方研报 | /posts/today |
1000(批发) |
以「建立一支球队的完整档案」为例:搜索拿 ID(2 点)+ 高阶画像(10 点)+ 伤停(5 点)+ 核心球员(10 点)= 27 点,约 0.27 元。500 点体验额度能做 18 支球队的完整档案,或者 10 场单场全景数据包。
五、有哪五个实战省钱策略?
策略一:用搜索接口拿 ID,不要盲试。所有数据接口都要用数字 ID。/teams?q=队名(2 点)拿到 ID 之后再调详情——不要靠猜 ID 反复试错。
策略二:优先用单场全景包,不要拼装。一场比赛的近期战绩、攻防数据、伤停、交锋全在 /match-pack/{id} 里(50 点,还内置了市场波动区块)。如果你拆成 8 个零散接口去拼,总点数更贵,还容易漏维度。
策略三:取整队球员数据,用批量接口。查一支球队多名球员的高阶指标,用 /teams/{id}/players-advanced(10 点、最多 20 人);不要逐个调 /players/{id}/advanced(3 点/人)——查 10 个人就从 10 点变成 30 点。
策略四:先查本地,再调接口。球小策官方 Skill 内置本地数据层:先查本地库,命中且未过期就直接用,0 点。赛果这类事实数据永不失效,赛程缓存 12 小时,伤停 6 小时,市场参考值 30 分钟,单场数据包 1 小时。
策略五:高成本内容先给官网链接。研报类接口单次 25~1000 点。如果只是想「看」研报,官网页面直接就能看,不需要花点数:历史复盘与命中统计 | 今日赛事前瞻。只有当你需要把内容拉下来二次加工时,再调接口。
六、最容易踩的坑是什么?
把「能用」和「划算」搞混。
新手最常见的浪费不是买错接口,而是用循环逐个取数据:为了拿一支球队 15 名球员的高阶数据,循环调了 15 次单人接口,花掉 45 点——而批量接口只要 10 点。这类错误在点数消耗记录里非常显眼。
养成一个习惯:凡是「同一类数据、多个对象」,先想有没有批量接口。常见的批量入口有三个:/match-pack/{id}(一场全景)、/teams/{id}/players-advanced(一队球员)、/today/digest(当天所有赛事)。
下一步该看什么
- 亲手跑通第一个请求 → 4.3 跑通第一个请求
- 46 个接口怎么选 → 4.4 接口地图
- 点数不足怎么排查 → 4.8 错误码与排障
足球赛事前瞻 | AI 智能分析 | 足球数据解读 - 球小策