Tạo bài tập

Stable

Nhận vào tiêu chí và mã lỗi cụ thể cùng vài bài mẫu tham chiếu, trả về bộ bài tập bám đúng lỗi đó. Dạng bài và số câu do mã lỗi quyết định, không cần chọn tay.

Chạy thử

Thao tác từng bước trên trình duyệt và xem đúng những lệnh gọi mà backend thực hiện.

Mở demo ›

Danh mục

Bộ API xử lý bài viết IELTS — chấm điểm, sinh bài tập bám đúng lỗi sai, và dựng lộ trình luyện tập cá nhân hoá.

Xem tất cả sản phẩm ›

1. Tổng quan

Sinh bài tập luyện viết bám đúng lỗi sai của học viên, dựa trên bài làm thật đã được gán nhãn lỗi trong hệ thống WISPACE.

Base URLtest-api-ielts-writing.aihubproduction.com
Định dạngapplication/json
Xác thựcAPI Key (x-client-id / x-secret-key) hoặc Bearer Token
Trạng tháiStable

2. Các bước tích hợp

Luồng tích hợp tạo bài tập vào hệ thống của bạn, từ chọn tiêu chí đến duyệt kết quả.

Chọn tiêu chí cần luyện
Xác định writing_task (1 hoặc 2), topic (environment | technology | education), criterion và error_code tương ứng. error_code sẽ quyết định dạng bài và số câu sinh ra ở bước 3, không cần chọn tay.
Lấy dữ liệu tham chiếu
Gọi sample-references để lấy các bài làm thật chứa đúng lỗi cần luyện, dùng làm ngữ cảnh cho AI. Nếu DB chưa đủ dữ liệu, endpoint trả 404 — cho phép người dùng tự nhập reference bằng tay.
Sinh bài tập
Gọi create-micro-exercise (một lỗi) hoặc create-longwriting-exercise (nhiều lỗi cùng lúc) với reference vừa lấy được. Response theo cơ chế graceful fallback — luôn trả 200, nếu AI sinh lỗi định dạng thì exercise rỗng kèm message giải thích thay vì trả lỗi 500.
Duyệt và quyết định
Xem trước bài tập (bản render hoặc JSON thô), Accept nếu đạt hoặc Retry kèm lý do để sinh lại. Bản nháp AI gốc và bản đã chỉnh sửa nên được lưu tách biệt để dùng làm dữ liệu fine-tuning sau này.