KEATH.AI

KEATH Public API documentation.

Get Started Examples

Public API v1

Authenticate with X-API-Key and call /api/keath/public/v1 endpoints directly for model access and grading.

Multimodal Ingest

Parse question papers and rubrics from PDF files, images, or existing public URLs.

Async Evaluation

Submit essay text or answer files to an existing assignment and poll the grading result asynchronously.

Assignment Creation

Create marking models, then create student assignments from selected model_id values.

Feedback Rewrite

Rewrite generated feedback in bullet points, paragraphs, or short sentences.

Plain-Language Docs

Human-readable guides in English, Chinese, French, Spanish, and Arabic.

Agent Ready

Designed for CLI tools, external integrations, and agentic workflows.

Read This First

KEATH grades student writing with a model you already trained or selected.

The two IDs matter:

model_id means the marking model. Get it from GET /models.
assignment_id means a student assignment. Create it with POST /assignments, or copy it from a KEATH assignment URL such as ...?id=1620.

If you want the normal classroom flow, use model_id to create an assignment, then grade with assignment_id. If you do not want to create an assignment, use one-pass evaluation with model_id.

Choose a language: