AI 出题 API 示例
通过 API 调用小杭题库 AI 出题引擎的代码示例。
API 概览
小杭题库提供 RESTful API，支持通过编程方式调用 AI 出题、组卷、批改等核心功能。
基本调用
认证方式
所有 API 请求需要在 Header 中携带 API Key：
Terminal
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.tiku.xhwlgzs.cn/v1/questions/generate
AI 出题请求
发送知识点和参数，获取 AI 生成的题目：
请求体
{
"knowledge_point": "行政处罚的种类",
"question_type": "single_choice",
"difficulty": "medium",
"count": 5,
"language": "zh-CN"
}
响应
{
"code": 0,
"data": {
"questions": [
{
"id": "q_abc123",
"content": "下列哪项不属于行政处罚的种类？",
"type": "single_choice",
"options": [
{"key": "A", "content": "警告"},
{"key": "B", "content": "罚款"},
{"key": "C", "content": "拘役"},
{"key": "D", "content": "吊销许可证"}
],
"answer": "C",
"analysis": "拘役属于刑事处罚而非行政处罚。根据《行政处罚法》，行政处罚的种类包括警告、罚款、没收违法所得、责令停产停业、暂扣或吊销许可证等。",
"knowledge_points": ["行政处罚法", "处罚种类"],
"difficulty": "medium"
}
]
}
}
高级用法
基于文档出题
上传教材文档，AI 基于文档内容生成题目：
Terminal
curl -X POST https://api.tiku.xhwlgzs.cn/v1/questions/generate-from-doc \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@chapter1.pdf" \
-F "question_type=multi_choice" \
-F "count=10"
批量组卷
一键生成完整试卷：
组卷请求
{
"subject": "行政法",
"total_score": 100,
"duration_minutes": 120,
"sections": [
{
"name": "单选题",
"question_type": "single_choice",
"count": 30,
"score_per_question": 1
},
{
"name": "多选题",
"question_type": "multi_choice",
"count": 10,
"score_per_question": 2
},
{
"name": "案例分析",
"question_type": "case_analysis",
"count": 2,
"score_per_question": 25
}
]
}
完整 API 文档和 SDK 下载，请联系我们的技术支持团队。