📝 AI作文批改

对提交的作文内容进行专业评分和详细批改建议。支持中文和英文作文，支持文本提交和文件上传。

请求URL	POST /api/grade 或 GET /api/grade
请求方法	POST / GET
认证方式	API Key（请求头：X-API-Key）

参数名	必填	类型	说明
content	是*	string	作文内容（文本方式提交时必填，至少10个字符）
essay_file	是*	file	作文文件（文件上传方式，支持 .txt, .md, .doc, .docx 格式，与 content 二选一）
topic	否	string	作文题目或主题
requirements	否	string	作文要求（如字数要求、格式要求等）
criteria	否	string	批改标准，可选值：comprehensive（综合，默认）、content（内容）、structure（结构）、language（语言）、grammar（语法）

请求示例

POST 请求（JSON）：

{
  "content": "科技的发展给人们的生活带来了巨大的变化。智能手机让我们随时随地都能与他人联系，获取信息。人工智能技术正在改变我们的工作方式。然而，我们也需要关注科技发展可能带来的负面影响，比如隐私泄露等问题。",
  "topic": "科技对生活的影响",
  "requirements": "字数要求：200字以上",
  "criteria": "comprehensive"
}

POST 请求（文件上传，multipart/form-data）：

Content-Type: multipart/form-data

content: (可选，如果提供文件则不需要)
essay_file: (文件，支持 .txt, .md, .doc, .docx)
topic: 科技对生活的影响
requirements: 字数要求：200字以上
criteria: comprehensive

GET 请求：

GET /api/grade?content=科技的发展给人们的生活带来了巨大的变化...&topic=科技对生活的影响&criteria=comprehensive

参数名	类型	说明
code	integer	状态码，1 表示成功，0 表示失败
essay_topic	string	作文题目（成功时返回）
language	string	检测到的语言类型：chinese 或 english（成功时返回）
criteria	string	使用的批改标准（成功时返回）
grading_result	string	AI生成的批改结果（包含评分、评价、建议等，成功时返回）
model	string	使用的AI模型名称（成功时返回）
word_count	integer	作文字数（成功时返回）
using_backup	boolean	是否使用了备用模型（可选，成功时可能返回）
msg	string	错误信息（失败时返回）

响应示例

成功响应：

{
  "code": 1,
  "essay_topic": "科技对生活的影响",
  "language": "chinese",
  "criteria": "comprehensive",
  "grading_result": "【总体评分】85分\n\n【内容评价】文章结构清晰，观点明确，但在词汇多样性和语法准确性方面还有提升空间。\n\n【详细评分】\n- 内容：90分\n- 结构：85分\n- 语言：80分\n- 语法：82分\n\n【修改建议】\n1. 建议增加更多具体例子来支撑观点\n2. 注意主谓一致的问题\n3. 可以使用更丰富的连接词使段落过渡更自然",
  "model": "deepseek-chat",
  "word_count": 85
}

成功响应（使用备用模型）：

{
  "code": 1,
  "essay_topic": "未指定题目",
  "language": "chinese",
  "criteria": "comprehensive",
  "grading_result": "...",
  "model": "maas",
  "word_count": 85,
  "using_backup": true
}

失败响应：

{
  "code": 0,
  "msg": "作文内容不能为空，且应至少包含10个字符"
}

错误码	说明
400	请求参数错误（如缺少必填参数 content 或 essay_file，或内容少于10个字符，或不支持的文件格式）
401	未提供API密钥或密钥无效
429	请求过于频繁，触发限流
500	服务器内部错误（AI模型调用失败等）