8.2 常见问题 FAQ(持续更新)
FAQ把下面这段发给你的 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 这类指标前,先按文档校正口径;样本不足要在结论里注明。
· 缺数据就说缺什么,不要用「大概」「可能」糊过去。
· 不给投注建议,不承诺准确率。
· 如果回答主要依据了某篇文档,请把链接带上,方便我自己核对。
这一页收集最常见的问题,持续更新。遇到问题先来这里找,找不到再联系我们。
一、产品定位是什么?
Q:球小策是做什么的?
一套专业足球数据与 AI 赛前分析的技能包:提供客观数据底座、高阶战术指标与量化分析能力,供创作者和开发者做内容与二次开发。我们不提供投注建议,不做预测服务。
Q:数据从哪来?
来自公开数据源,经过清洗、对齐与标定后形成结构化数据。高阶指标是在这些基础数据上建模计算得到的。
Q:和市面上的数据服务有什么区别?
两点:一是我们提供可解释的高阶指标(每个指标都能说清怎么算的、能回答什么、不能回答什么);二是我们提供面向 AI 的使用方式(装上 Skill 后,AI 能自己取数分析,不需要你自己搭流程)。
二、账号与密钥相关的问题有哪些?
Q:怎么获得密钥?
进入 我的数据服务 微信扫码登录,首次登录自动建号并显示专属密钥。密钥以 qxz_ 开头。
Q:有免费额度吗?
有,新账号赠送 500 点体验额度,不需要绑卡。
Q:密钥会过期吗?
会。控制台与余额接口都会显示有效期。过期后调用接口会返回 402(credits_expired)。
Q:密钥泄露了怎么办?
立刻在控制台重置。重置后旧密钥立即失效,新密钥可直接替换使用。
三、计费与成本相关的问题有哪些?
Q:怎么计费?
1 元 = 100 点,按接口扣点,调用失败不计费。未知路由按 2 点计费,所以 URL 要拼对。
Q:哪些接口免费?
余额自查、生成任务进度查询——这两个都是 0 点。
Q:同一个请求重复调用会重复扣点吗?
不会。同一密钥 + 同一接口 + 同一参数,60 秒内重复调用不重复扣点。
Q:有调用频率限制吗?
有,每分钟 30 次请求。超出会返回 429。
Q:充值是整数吗?有优惠吗?
有折扣阶梯(充得越多折扣越大),单笔有上限。具体以控制台内显示为准。
四、接口使用相关的问题有哪些?
Q:一共多少个接口?
46 个,按功能分成 8 组,完整清单见 4.4 接口地图。
Q:为什么所有接口都要传数字 ID?
ID 是唯一标识,用名称会有歧义(同名球队、同名球员很常见)。所以流程永远是:先用搜索接口拿到 ID,再调详情。
Q:搜到多个同名结果怎么办?
不要直接拿第一条用。核对返回里的国家、是否国家队、别名等字段;仍不唯一时,列出候选让人确认。
Q:返回 404 是什么原因?
绝大多数是 ID 错了。也可能是赛季口径不对,或该场比赛尚未入库。
Q:数据多久更新一次?
不同数据不一样:赛果完赛即入库且不再变;伤停约 6 小时;市场参考值约 30 分钟;单场数据包约 1 小时。
五、Skill 与 AI 使用相关的问题有哪些?
Q:我不会写代码,能用吗?
能。装上 Skill 之后,你对着 AI 说人话就行——「帮我分析今晚曼城那场」,它会自己解析队名、定位比赛、取数据。详见 5.1 零代码实操。
Q:纯网页版 AI 能用吗?
能,但装不了 Skill,也就无法自动取数。你需要手动把数据粘贴给它。建议至少用支持 Skill 的工具。
Q:怎么判断 AI 是真的在调接口,还是编的?
让它报字段名。真实数据能说出 xg、form_rating 这类字段名,编的说不出来。说不出字段名的内容,一律当编造处理。
Q:它说「数据未提供」,是不是没查?
通常是真没有。国家队赛事没有球员高阶数据、门将没有专属指标、小联赛覆盖有限——这些都是已知边界。详见 3.1 数据全景。
六、高阶指标与自建系统相关的问题有哪些?
Q:OTI / DII / GIM分别是什么?
OTI 是进攻威胁指数(进攻威胁来自哪里、有多大);DII 是防守参与度指数(只描述防守动作参与量,不代表防守强弱);GIM 是比赛影响力(球员对整场比赛的影响,队内相对分)。详见 3.3 / 3.4 / 3.5。
Q:判断防守好坏该看什么?
只看预期失球(xGA)和零封率。防守参与度不能用来看防线强弱。
Q:为什么没有门将的高阶指标?
球员高阶算法目前跳过门将位置——门将需要单独设计指标。评估门将只能借助球队层面的失球与预期失球,或公开的扑救统计。
Q:你们公开算法吗?
公开方法论(指标定义、公式结构、验证方法、边界),不公开生产参数。详见 7.1 边界声明。
Q:能自己搭一套类似系统吗?
可以。7.11 起有一整套从架构到回测的方法——而且每一步都会告诉你「怎么让 AI 帮你实现」,不需要自己写代码。
七、内容创作相关的问题有哪些?
Q:能帮我写内容吗?
能。装上 Skill 后可以直接说「写一篇公众号」「做个小视频脚本」。三个平台的完整流程见 6.1 / 6.2 / 6.3。
Q:写出来的内容能直接发吗?
建议跑一遍发布前合规自检(见 6.6),并自己过一遍数据准确性。把 AI 生成的内容直接发出去,责任在你。
Q:为什么不能写「这场稳了」?
这类表述属于结果保证,是明确的内容红线。换成数据描述:把「主队防守很强」写成「主队近 5 场预期失球 0.71」。
八、还有哪些常见问题?
Q:有没有官方交流渠道?
有,见 8.5 联系我们。
Q:文档里的内容会更新吗?
会。更新记录见 8.3 更新日志与路线图。
Q:遇到文档里找不到答案的问题怎么办?
带着具体信息联系我们:调用的完整 URL(密钥脱敏)、返回的状态码与响应体、一个可复现的最简例子。
足球赛事前瞻 | AI 智能分析 | 足球数据解读 - 球小策