---
title: "Grade Writing"
method: POST
path: "/api/v1/ai/{provider}/grade-writing"
tags: ["api", "api", "ai"]
---

# Grade Writing

`POST /api/v1/ai/{provider}/grade-writing`

## Request

- Base URL: `https://www.faroz.uz` (the document declares no server; this is the origin it was published from)
- URL: `https://www.faroz.uz/api/v1/ai/{provider}/grade-writing`
- Auth: HTTP bearer

Yozma matnni CEFR daraja bo'yicha baholaydi (tanlangan AI bilan).

## Path parameters

- `provider` 'claude' | 'gpt' | 'gemini' | 'deepseek', required: Qaysi AI provayderdan foydalanish. URL prefiksi sifatida ham ishlatiladi: /api/v1/ai/{provider}/...

## Request body

- GradeWritingRequest
  - `text` string, required: O'quvchi yozgan matn
  - `target_level` 'A1' | 'A2' | 'B1' | 'B2' | 'C1' | 'C2', required: CEFR til darajasi (A1–C2). AI mashq generatsiyasida o'quvchining darajasini belgilash uchun ishlatiladi.
  - `prompt` string, nullable: Topshiriq matni (mavzu yoki savol)
  - `language` string: Fikr-mulohazalar tili

## Response `200`

Successful Response

- GradeWritingResponse
  - `estimated_level` 'A1' | 'A2' | 'B1' | 'B2' | 'C1' | 'C2', required: CEFR til darajasi (A1–C2). AI mashq generatsiyasida o'quvchining darajasini belgilash uchun ishlatiladi.
  - `score` integer, required
  - `summary` string, required
  - `strengths` string[], required
  - `areas_to_improve` string[], required
  - `errors` WritingErrorItem[], required
    - `excerpt` string, required
    - `error_type` string, required
    - `suggestion` string, required
    - `explanation` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/faroz/apis/edu-app-api.md) · [All operations](https://skmtc.dev/faroz/apis/edu-app-api/llms.txt) · [OpenAPI document](https://skmtc.dev/faroz/apis/edu-app-api/revisions/414a551ba773?raw)