Изображение в текст

POST /api/v1/image-to-text

Запрос

Отправьте POST с одним изображением в multipart-поле image, заменив YOUR_API_KEY и document.png. Позвольте cURL задать границу multipart. Допускается только необязательный параметр format, без дополнительных полей и настроек модели. См. Bearer-аутентификацию и защиту ключа.

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"
  }
}

Форматы вывода

Допускается один необязательный параметр format=json|text|docx. Неизвестные, повторные или неверные параметры дают 400 до распознавания. json (по умолчанию) содержит Markdown в text, в том числе HTML-таблицы и LaTeX. text преобразует только text в обычный текст, сохраняя usage и billing. docx возвращает вложение Word result.docx.

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

curl --silent --show-error --fail --max-time 150 \
  'https://freeaiocr.com/api/v1/image-to-text?format=docx' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: example-request-0001' \
  -F 'image=@document.png' \
  --dump-header - --output result.docx

Для Word используются Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document и Content-Disposition: attachment. Используйте файл только после успешного завершения cURL и проверки Content-Type. X-Request-Id, X-OCR-Charged-USD и X-OCR-Price-Version относятся к исходному распознаванию. Cache-Control: no-store и соответствующий Idempotency-Replayed сохраняются.

В течение 24 часов можно менять формат с тем же аккаунтом, байтами изображения, MIME и Idempotency-Key без повторной платы за распознавание. После истечения срока возможна новая платная операция. Преобразование старого текста не восстанавливает утраченную структуру.

export_failed (503) означает, что распознавание успешно и уже оплачено, но преобразование не удалось; recognition_succeeded в JSON-ошибке равно true. Повторите с исходным изображением и ключом до истечения срока или запросите format=json. Возврата платы и нового распознавания не происходит. Word содержит редактируемые текст и таблицы, без точного исходного макета; формулы остаются текстом LaTeX.

Для каждой новой операции или эндпоинта нужен другой Idempotency-Key; совместное использование в текстовом и табличном API даёт 409 idempotency_conflict. Смена формата той же операции сохраняет исходные ключ и изображение. См. идемпотентность и тарифы.