# ИИ-обработка текста

export default function Layout(props) {
  const { OpenAPIPage } = props.components ?? {};
  return (
    <>
      {props.children}
      ## ИИ-обработка текста

`POST /api/v1/smartdoc/ai/transform`

**Авторизация:** dpop или oauth2: `smartdoc:write`

**Тело запроса** (`application/json`, обязательное): AiTransformRequest
- `action`: "rephrase" | "simplify" | "shorten" | "extend" | "check" | "translate" | "ask", обязательное — Действие: rephrase — перефразировать, simplify — упростить, shorten — сократить, extend — дополнить, check — проверить на ошибки, translate — перевести на английский, ask — задать вопрос по тексту
- `question`: string — Вопрос по тексту; обязателен при action=ask
- `text`: string, обязательное — Исходный текст (для ask — контекст вопроса)

**Ответы**

- `200` — Обработанный текст (`application/json`, AiTransformResponse)
  - `result`: string, обязательное — Результат обработки текста моделью
- `400` — Некорректный запрос: не прошла валидация параметров или тела (`application/problem+json`, ProblemDetails)
- `401` — Токен отсутствует, недействителен или истёк (`application/problem+json`, ProblemDetails)
- `403` — Недостаточно прав или scope (`application/problem+json`, ProblemDetails)

    </>
  );
}
