# Распознать текст в изображении или PDF

> Требуемое право: text.

`POST https://api.kvantora.ai/v1/ocr`

Требуемое право: text. Принимает изображение или PDF через file_id или file_ids. Асинхронный JSON-контракт Kvantora; не полная совместимость с OpenAI media API. Результаты возвращаются в файлах. Единица и quantity берутся из опубликованного тарифа каталога: request, image, character, page, file, document, second или minute. Оценка /v1/quotes относится ко всему заданию. Неизвестная стоимость блокирует запуск до резерва. Входные файлы принадлежат владельцу ключа и проходят проверку; параметры должны поддерживаться моделью.

## Параметры

- `Idempotency-Key` (header, обязательный): Один стабильный ключ на логический запрос. Повторяйте с тем же телом и тем же credential/endpoint. Новый ключ создаёт новый запрос.

## Пример запроса

```bash
curl --request POST \
  --url "https://api.kvantora.ai/v1/ocr" \
  --header "Authorization: Bearer $KVANTORA_API_KEY" \
  --header "Idempotency-Key: $REQUEST_ID" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "<public_api_id>",
  "file_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'
```

## Ответы

- 200: Повтор уже завершённого задания
- 202: Задание принято
- default: Ошибка проверки, прав, лимита или доступности. Код error.code; результат запроса при неизвестном исходе не следует считать отменённым.