Skip to main content
FreeAIOCR logoFreeAIOCR
Документация API

Обзор API

Встраивайте распознавание текста и извлечение таблиц с общим ключом API и балансом, оплачивая использование.

APIAPI KeysОплата API

Выбор API

API FreeAIOCR позволяет распознавать текст и извлекать таблицы из изображений. Выберите соответствующий справочник выше, чтобы узнать поддерживаемые форматы.

Быстрый старт

  1. Подтвердите адрес электронной почты аккаунта
  2. Создайте API-ключ в настройках и сохраните его: ключ отображается только один раз
  3. Пополните баланс API на $5. Все ключи делят этот баланс, он не связан с подписками сайта и не имеет срока действия
  4. Отправьте пример запроса с сервера, заменив YOUR_API_KEY и document.png
  5. Проверьте распознанный текст, число токенов и сумму списания в ответе

Аутентификация

Authorization: Bearer YOUR_API_KEY

Используйте Bearer-токен по HTTPS и храните ключ на сервере. Междоменные вызовы браузера не поддерживаются. Не публикуйте ключ в открытом коде.

Первый запрос

Используйте POST, Bearer-ключ и ровно один файл в поле image. Замените YOUR_API_KEY и document.png. Content-Type multipart и границу задаёт cURL. Допускается только необязательный параметр URL format; дополнительные поля формы и настройки модели не принимаются. Вызывайте с сервера; междоменные вызовы браузера не поддерживаются. Не публикуйте ключ.

curl --silent --show-error --include --max-time 150 \
  'https://freeaiocr.com/api/v1/image-to-text' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: example-request-0001' \
  -F 'image=@document.png'

Чтение ответа

Приведённый JSON — пример: распознанный текст и расход токенов зависят от изображения.

{
  "request_id": "b2c8ec98-2a36-4f87-99d2-3d7839b92518",
  "text": "# Document title\n\nRecognized paragraph.\n\n| Item | Count |\n| --- | --- |\n| Books | 12 |",
  "usage": {
    "input_tokens": 2000,
    "output_tokens": 4000
  },
  "billing": {
    "currency": "USD",
    "price_version": "2026-10-26-v1",
    "base_usd": "0.002000000",
    "input_overage_usd": "0.000000000",
    "output_overage_usd": "0.002400000",
    "total_usd": "0.004400000"
  }
}

Безопасные повторы

При сетевой ошибке повторяйте запрос с тем же Idempotency-Key и исходным изображением. Новой операции нужен новый уникальный ключ. Не создавайте другую операцию, пока результат или списание предыдущей не определены. Подробности см. в стратегии повторов.

Общие руководства относятся к API текста и таблиц. Входные данные, форматы и особые ошибки описаны в справочнике каждого API.