4.1 快速入门:1 分钟获取专属 Key 与 500 点体验金
入门实操把下面这段发给你的 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 这类指标前,先按文档校正口径;样本不足要在结论里注明。
· 缺数据就说缺什么,不要用「大概」「可能」糊过去。
· 不给投注建议,不承诺准确率。
· 如果回答主要依据了某篇文档,请把链接带上,方便我自己核对。
这一篇带你从零拿到 API 密钥,全程不超过 1 分钟。不写代码也能用上——下面会给你两条路。
一、球小策创作者 API 能帮你做什么?
它是一套面向 AI 智能体、内容创作者与开发者的足球数据服务:把清洗过的高阶数据,通过标准 HTTP 接口开放给你。
- 覆盖主流联赛与杯赛的赛程、赛果、阵容、伤停;
- 提供高阶指标:预期进球(xG / xGA)、进攻威胁(OTI)、防守参与度(DF-DII)、比赛影响力(GIM)、即时战力(Form)、稳定性(Consistency)、疲劳负荷;
- 提供市场参考值、官方公开参考值与复盘统计;
- 提供单场全景数据包——一次调用覆盖一场比赛的全部维度。
如果你还不确定这些指标各自能回答什么问题,先看 3.1 数据全景,那里有一张完整的指标地图。
二、怎么在 1 分钟内拿到密钥?
第一步:登录控制台。进入 我的数据服务,用微信扫码登录。首次登录自动建号,不需要填任何资料。
第二步:领取体验点数。新账号自动获得 500 点体验额度,折合 5 元,够你把所有主要接口各跑一遍。无需绑卡、无需付费。
第三步:复制密钥。控制台首屏会显示你的专属 API Key,形如:
qxz_xxxxxxxxxxxxxxxxxxxxxxxx
点复制按钮即可。密钥以 qxz_ 开头,看到这个前缀就知道是对的。
控制台首屏同时提供一个「一键安装」口令,已经自动带上你的真实密钥——如果你只是想在自己的 AI 工具里用上这些数据,直接复制那一段就行,不用看下面的接口细节。
三、拿到密钥之后,两条路你选一条
路线 A · 不写代码怎么用?
把数据交给 AI,让 AI 去调接口、读数据、写文章。你只需要做一件事:在支持技能包的 AI 工具里装上球小策 Skill,然后把密钥发给它。
装好之后,你对着 AI 说人话就行:
完整安装步骤见 5.1 一键挂载 Skill。装好之后,你从此不需要自己记任何接口名。
路线 B · 自己调接口怎么开始?
把下面这段贴进终端,能返回余额就说明全链路通了(查余额 0 点,免费):
curl -s 'https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/quota'
-H 'X-API-Key: YOUR_API_KEY_HERE'
看到 remaining 为正数就成功了。接下来从 4.3 跑通第一个请求继续。
四、接口基础信息有哪些必须知道的?
| 项目 | 值 |
|---|---|
| 接口地址(Base URL) | https://www.qiuxiaoce.com/wp-json/abv2-creator/v1 |
| 认证方式 | 请求头 X-API-Key: 你的密钥 |
| 计费方式 | 按接口扣点,失败不计费;1 元 = 100 点 |
| 新用户额度 | 500 点体验额度 |
| 限流 | 每分钟最多 30 次请求,超出返回 429 |
| 去重 | 同一密钥、同一接口、同一参数在 60 秒内重复调用不重复扣点 |
| 接口总数 | 46 个(分组见 4.4 接口地图) |
其中 60 秒去重这一条对新手特别重要:调试时反复请求同一个地址是不会重复花钱的,放心试。
五、上线前有哪三条安全提醒?
提醒一:密钥等同于你的余额。谁拿到它,就能花你的点数。不要贴到公开的代码仓库、群聊、截图或教程里。
提醒二:用环境变量管理密钥,不要写死在代码里。推荐写成环境变量 QIUXIAOCE_API_KEY,代码里只读变量。
提醒三:一旦怀疑泄露,立刻在控制台重置。重置后旧密钥立即失效,补发的新密钥可以直接替换使用。
六、新手最常问的三个问题
| 问题 | 回答 |
|---|---|
| 密钥会过期吗? | 会。控制台与余额接口都会显示有效期,接口在到期后会返回 402。写代码时建议把有效期也读出来做个提醒。 |
| 额度用完了怎么办? | 控制台内自助充值,1 元 = 100 点;充值有折扣阶梯,详见 4.2 计费与省钱。 |
| 我完全不会写代码,能用吗? | 能。走上面的路线 A,装好 Skill 后对着 AI 说人话即可,全程不需要碰任何代码。 |
下一步该看什么
- 怎么花钱最省 → 4.2 计费与省钱
- 亲手跑通第一个请求 → 4.3 跑通第一个请求
- 直接在 AI 工具里用,不写代码 → 5.1 一键挂载 Skill
足球赛事前瞻 | AI 智能分析 | 足球数据解读 - 球小策