API распознавания текста

curl

curl -X POST https://toolsie.ru/api/v1/ocr \
  -H "Authorization: Bearer ВАШ_КЛЮЧ" \
  -F "tool=nakladnaya-v-excel" \
  -F "file=@nakladnaya.jpg"

PHP

cURL. Ключ держите в переменной окружения, не в репозитории.

<?php
$key = getenv('TOOLSIE_API_KEY');
$ch = curl_init('https://toolsie.ru/api/v1/ocr');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["Authorization: Bearer $key"],
  CURLOPT_POSTFIELDS => [
    'tool' => 'nakladnaya-v-excel',
    'file' => new CURLFile('/path/to/nakladnaya.jpg', 'image/jpeg', 'nakladnaya.jpg'),
  ],
]);
$res = curl_exec($ch);
curl_close($ch);
$data = json_decode($res, true);
echo $data['text'] ?? $data['error'] ?? 'empty';

Python

requests. Для табличных tool= поле text — это CSV.

import os
import requests

r = requests.post(
    "https://toolsie.ru/api/v1/ocr",
    headers={"Authorization": f"Bearer {os.environ['TOOLSIE_API_KEY']}"},
    files={"file": open("nakladnaya.jpg", "rb")},
    data={"tool": "nakladnaya-v-excel"},
    timeout=60,
)
r.raise_for_status()
print(r.json()["text"])
print("осталось:", r.headers.get("X-RateLimit-Remaining"))

Node.js

Встроенный fetch (Node 18+) и FormData.

import fs from "node:fs";

const form = new FormData();
form.set("tool", "nakladnaya-v-excel");
form.set("file", new Blob([fs.readFileSync("nakladnaya.jpg")]), "nakladnaya.jpg");

const res = await fetch("https://toolsie.ru/api/v1/ocr", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.TOOLSIE_API_KEY}` },
  body: form,
});
const data = await res.json();
if (!res.ok) throw new Error(data.error || res.statusText);
console.log(data.text);

JavaScript в браузере

Ключ на фронте светить нельзя — проксируйте через свой бэкенд. Ниже — вызов со своего сервера или если ключ только для внутреннего инструмента.

async function recognize(file) {
  const form = new FormData();
  form.set("tool", "chek-v-excel");
  form.set("file", file);

  const res = await fetch("https://toolsie.ru/api/v1/ocr", {
    method: "POST",
    headers: { Authorization: "Bearer ВАШ_КЛЮЧ" },
    body: form,
  });
  const data = await res.json();
  if (!res.ok) throw new Error(data.error || "ocr_failed");
  return data.text;
}

document.querySelector("input[type=file]").addEventListener("change", async (e) => {
  const file = e.target.files?.[0];
  if (file) console.log(await recognize(file));
});

Google Apps Script

Удобно, если учёт живёт в Google Таблицах. Через JSON + base64.

function recognizeDriveFile(fileId) {
  var key = PropertiesService.getScriptProperties().getProperty('TOOLSIE_API_KEY');
  var blob = DriveApp.getFileById(fileId).getBlob();
  var res = UrlFetchApp.fetch('https://toolsie.ru/api/v1/ocr', {
    method: 'post',
    contentType: 'application/json',
    headers: { Authorization: 'Bearer ' + key },
    payload: JSON.stringify({
      tool: 'chek-v-excel',
      mime: blob.getContentType() || 'image/jpeg',
      filename: blob.getName(),
      image_base64: Utilities.base64Encode(blob.getBytes()),
    }),
    muteHttpExceptions: true,
  });
  var data = JSON.parse(res.getContentText());
  return data.text || data.error;
}