K12 题库 API

最后更新: 2026-06-21

K12 题库 API 让 Agent 用 k12_questions 按学科、年份、知识点检索小学/初中/高中题目、题图、答案和解析，用于组卷、备课和个性化练习。小初高通过 subject 等 filters 区分。

数据覆盖：题目约 1656 万条 · 题图 1085 万条 · 覆盖小初高

source	k12_questions
典型 filters	subject, year, knowledge
query	完整自然语言意图，如“浮力与重力关系的判断与计算”
返回格式	默认 markdown，可请求 return.format=json
适用任务	组卷、备课、知识点练习、错题归纳

什么时候用 K12 题库 API

小初高怎么区分

POST https://api.huohuaapi.com/v1/search
{
  "source": "k12_questions",
  "purpose": "找初中物理浮力与重力关系的题目和解析",
  "filters": {
    "subject": "物理",
    "knowledge": "浮力"
  },
  "query": "浮力与重力关系的判断与计算"
}

把这个数据源接入你的 Agent

方式一(推荐):装成 Claude Code / Codex 技能,Agent 需要时自动调用。

curl -fsSL https://skills.huohuaapi.com/k12_questions/install.sh | sh

方式二:直接调 API(token 到控制台开通该数据源)。

curl -s "https://api.huohuaapi.cn/v1/search" \
  -H "Authorization: Bearer $HUOHUA_DATA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"source":"k12_questions","query":"...","filters":{}}'

默认入口 https://api.huohuaapi.cn/v1(国内直连),海外或连接失败改用 https://api.huohuaapi.com/v1;功能与计费一致。

收费 · ¥5 / 100 次:按成功返回计费(空结果/报错不扣费),从余额扣减,已含你的 token。使用前请先登录 / 注册获取 API Key;Agent 可直接用本页链接安装 skill。

和传统平台有什么不同

	学科网、组卷网等题库平台	火花数据API
面向对象	人(网页检索)	AI Agent(程序调用)
接入方式	登录网页 / 通常需订阅	API(/v1/search)+ 可安装 skill
返回形态	网页结果,人工摘录	结构化、带来源、可直接引用的 markdown
适用场景	人工查阅	Agent 自动检索 + 生成

常见问题

用 K12 题库 API 需要先注册吗？

可以先免注册充值获取 API Key 再调用；已有账号则在控制台开通数据源后调用。

小学、初中、高中怎么区分？

通过 subject 等 filters 区分学段与学科，同一个 k12_questions 数据源覆盖小初高。

自动组卷功能怎么实现？

用 k12_questions 按 subject、knowledge、year 检索题目，Agent 拿到题干、答案和解析后按需求自动组卷，无需自建题库。

AI 出题用哪个数据源？

用 k12_questions 检索带解析的小初高真题，作为 AI 出题或改编的素材底座。

题库 API 接口/查题接口怎么调用？

用 k12_questions 题库接口 POST /v1/search，按 subject、knowledge、year 查题，返回题干、题图、答案与解析，Agent 直接拿来查题、组卷或出题。

返回结果能直接引用吗？

可以。默认返回带来源的 markdown，适合 Agent 直接引用；需要结构化时请求 return.format=json。

空结果或 invalid_filter 怎么排查？

先放宽 filters、核对字段名与取值，再用更聚焦的 query 重试；仍为空说明该条件下暂无匹配材料。

和模型 API 有什么区别？

模型 API 走 /v1 生成文本；数据 API 走 /v1/search 用 k12_questions 检索可引用材料，二者可在同一 Agent 流程组合。

这个数据 API 有 skill 吗、能直接给 Agent / Claude Code 用吗？

可以。除了直接 POST /v1/search，还提供 skill 包：装进 Claude Code、Codex、Cline 等 Agent 后，Agent 会自动用 k12_questions 检索，无需手写请求。