📖 AI题目讲解

提供题目的详细解答过程和知识点讲解。

请求URL	POST /api/explain 或 GET /api/explain
请求方法	POST / GET
认证方式	API Key

• 智能难度调整：根据学生水平自动调整讲解深度
• 学习风格适配：支持多种学习风格的讲解方式
• 知识点关联：自动关联相关知识点并提供扩展学习
• 多维度讲解：提供解题思路、步骤详解、易错点分析

参数名	必填	类型	说明
question	是	string	题目内容
options	否	string	题目选项，每个选项占一行
type	否	string	题型，支持的题型包括： 基础题型：single(单选题), multiple(多选题), judgement(判断题), fill(填空题), short_answer(简答题), calculation(计算题), essay(论述题), coding(编程题) 高考题型：reading_comprehension(阅读理解), material_analysis(材料分析题), cloze_test(完形填空), translation(翻译题), writing(写作题), continuation_writing(读后续写), summary_writing(概要写作), error_correction(改错题), grammar(语法题), vocabulary(词汇题), paragraph_ordering(段落排序题), listening_comprehension(听力理解)
answer	否	string	正确答案
subject	否	string	学科名称，如：数学、物理、化学、英语、语文等
explain_level	否	string	讲解级别，可选值：brief(简要), detailed(详细), comprehensive(全面), adaptive(自适应)。默认为 adaptive
student_level	否	string	学生水平，可选值：beginner(初学者), intermediate(中级), advanced(高级)。默认为 intermediate
learning_style	否	string	学习风格，可选值：visual(视觉型), auditory(听觉型), kinesthetic(动觉型), logical(逻辑型), social(社交型), balanced(平衡型)。默认为 balanced
include_examples	否	boolean	是否包含例题，默认为 true
include_practice	否	boolean	是否包含练习题，默认为 true
focus_areas	否	string	重点关注领域，多个领域用逗号分隔，如 "解题思路,公式应用,易错点"

请求示例

方式1：JSON格式（POST）

{
  "question": "已知函数f(x)=x²+2x+1，求f(x)的最小值。",
  "options": "A. 0\nB. 1\nC. 2\nD. 3",
  "type": "single",
  "answer": "A",
  "subject": "数学",
  "explain_level": "detailed",
  "student_level": "intermediate",
  "learning_style": "visual",
  "include_examples": true,
  "include_practice": true,
  "focus_areas": "解题思路,公式应用"
}

方式2：GET请求

curl -X GET \
  -H "X-API-Key: your_api_key" \
  "https://tiku.anevol.cn/api/explain?question=已知函数f(x)=x²+2x+1，求f(x)的最小值。&type=single&answer=A&explain_level=detailed&student_level=intermediate&learning_style=visual"

参数名	类型	说明
code	integer	状态码，1表示成功，0表示失败
question	string	题目内容
question_type	string	题型
answer	string	正确答案（如果提供）
subject	string	学科名称（如果提供）
explain_level	string	使用的讲解级别
student_level	string	学生水平
learning_style	string	学习风格
explanation	string	详细讲解内容（包含知识点梳理、解题过程、答案说明等结构化内容）
model	string	使用的AI模型（格式：provider:model_name）
using_backup	boolean	是否使用了备用模型（可选字段）
features	object	功能特性信息

features对象结构

参数名	类型	说明
adaptive_level	boolean	是否使用了自适应讲解级别
include_examples	boolean	是否包含例题
include_practice	boolean	是否包含练习题
focus_areas	string	重点关注领域（如果提供）

响应示例

成功响应

{
  "code": 1,
  "question": "已知函数f(x)=x²+2x+1，求f(x)的最小值。",
  "question_type": "single",
  "answer": "A",
  "subject": "数学",
  "explain_level": "detailed",
  "student_level": "intermediate",
  "learning_style": "visual",
  "explanation": "【知识点梳理】\n这是一个关于二次函数最值的问题。主要涉及的知识点包括：\n1. 二次函数的标准形式和一般性质\n2. 配方法的原理和应用\n3. 完全平方式的性质：a²≥0，当且仅当a=0时取等号\n\n【题目解析】\n题目要求求二次函数f(x)=x²+2x+1的最小值。这是一个典型的二次函数最值问题，可以通过配方法来解决。\n\n【解题过程】\n步骤1：识别函数形式\n观察函数f(x)=x²+2x+1，这是一个开口向上的二次函数（a=1>0）。\n\n步骤2：使用配方法\nf(x) = x² + 2x + 1\n     = (x² + 2x) + 1\n     = (x² + 2x + 1) - 1 + 1\n     = (x + 1)²\n\n步骤3：确定最小值\n因为(x+1)²≥0，且当x+1=0即x=-1时，(x+1)²=0，所以f(x)的最小值为0。\n\n【答案说明】\n正确答案是A（0）。当x=-1时，f(x)=(x+1)²=0，这是函数的最小值。\n\n【注意事项】\n1. 配方法的关键是找到合适的常数项，使二次项和一次项构成完全平方\n2. 注意平方数的非负性，这是确定最值的关键\n3. 对于开口向上的二次函数，最小值在顶点处取得\n\n【个性化建议】\n作为中等水平的学生，你已经掌握了基本的函数概念。建议你：\n1. 多练习配方法，熟练掌握各种二次函数的配方技巧\n2. 尝试用图像法验证答案，加深对二次函数性质的理解\n3. 学习导数法求最值，这是更通用的方法",
  "model": "deepseek:deepseek-chat",
  "features": {
    "adaptive_level": false,
    "include_examples": true,
    "include_practice": true,
    "focus_areas": "解题思路,公式应用"
  }
}

失败响应

{
  "code": 0,
  "msg": "请提供题目内容"
}

错误码	说明
0	请求失败（参数错误、AI调用失败等）
400	请求参数错误（如缺少必填参数）
401	未提供API密钥或密钥无效
429	请求过于频繁
500	服务器内部错误