青鸾 Education OS API

访问管理后台申请 Key

前往 https://ql.wop.cc 创建您的 API Key。所有 Key 默认享有免费层配额（1000次/天）。

试试你的第一个 API 调用

以下示例调用 AI 出题接口，生成 3 道初中数学选择题：

curl -X POST https://ql.wop.cc/api/v1/generate/questions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "subject": "数学",
    "grade": "八年级",
    "knowledge_points": "一元二次方程",
    "question_types": ["单选"],
    "difficulty": 3,
    "count": 3
  }'

响应示例：

{
  "success": true,
  "questions": [
    {
      "type": "单选",
      "stem": "方程 x² - 5x + 6 = 0 的解是？",
      "options": ["A. x=2, x=3", "B. x=-2, x=-3", "C. x=1, x=6", "D. x=-1, x=-6"],
      "answer": "A",
      "analysis": "因式分解得 (x-2)(x-3)=0，所以 x=2 或 x=3。",
      "difficulty": 3
    }
    // ... 更多题目
  ]
}

Python SDK 风格调用

import requests
import json

API_BASE = "https://ql.wop.cc"
API_KEY = "YOUR_API_KEY"

headers = {
    "Content-Type": "application/json",
    "X-API-Key": API_KEY
}

# 1. AI 批改作文
resp = requests.post(f"{API_BASE}/api/v1/grade/essay", headers=headers, json={
    "essay": "我的家乡很美...",
    "prompt": "请以'我的家乡'为题写一篇作文",
    "max_score": 60,
    "grade_level": "八年级"
})
print("批改结果:", resp.json())

# 2. OCR 识别试卷
resp = requests.post(f"{API_BASE}/api/v1/ocr/scan", headers=headers, json={
    "image_base64": "base64_encoded_image..."
})
print("OCR 结果:", resp.json())

# 3. AI 智能讲解
resp = requests.post(f"{API_BASE}/api/v1/explain", headers=headers, json={
    "question": "什么是光合作用？",
    "answer": "光合作用是植物利用光能...",
    "method": "detailed",
    "level": "intermediate"
})
print("讲解结果:", resp.json())

# 4. 学情分析
resp = requests.post(f"{API_BASE}/api/v1/analyze/student", headers=headers, json={
    "student": "张三",
    "records": [
        {"subject": "数学", "score": 85, "date": "2026-06-15"},
        {"subject": "数学", "score": 78, "date": "2026-06-01"}
    ]
})
print("学情分析:", resp.json())