Image vers texte

POST /api/v1/image-to-text

Requête

Envoyez avec POST une seule image dans le champ multipart image, en remplaçant YOUR_API_KEY et document.png. Laissez cURL définir la limite multipart. Seul le paramètre facultatif format est accepté, sans champ ou réglage de modèle supplémentaire. Consultez l’authentification Bearer et la sécurité de la clé.

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'

La réponse JSON est illustrative : le texte et les tokens dépendent de l’image. Pour réessayer, consultez l’idempotence.

Réponse réussie (exemple d’usage)

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

Formats de sortie

Un seul paramètre facultatif est accepté : format=json|text|docx. Un paramètre inconnu, répété ou invalide renvoie 400 avant la reconnaissance. json (par défaut) fournit du Markdown dans text, avec éventuellement des tableaux HTML et du LaTeX. text convertit seulement text en texte brut ; usage et billing restent identiques. docx fournit la pièce jointe 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 utilise Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document et Content-Disposition: attachment. Utilisez le fichier seulement si cURL réussit et que le Content-Type correspond. X-Request-Id, X-OCR-Charged-USD et X-OCR-Price-Version décrivent la reconnaissance initiale. Cache-Control: no-store et, le cas échéant, Idempotency-Replayed sont conservés.

Pendant 24 heures, changez de format avec le même compte, les mêmes octets d’image, MIME et Idempotency-Key, sans nouvelle facturation de reconnaissance. Après expiration, une nouvelle opération payante est possible. La conversion d’un ancien résultat en texte brut ne restaure pas sa structure perdue.

export_failed (503) signifie que la reconnaissance a réussi et a été facturée, mais que la conversion a échoué ; recognition_succeeded vaut true dans l’erreur JSON. Réessayez avant expiration avec l’image et la clé d’origine, ou demandez format=json. Aucun remboursement ni nouvelle reconnaissance. Word conserve du texte et des tableaux modifiables, pas la mise en page exacte ; les formules restent du texte LaTeX.

Une nouvelle opération ou un autre endpoint exige un nouveau Idempotency-Key. Partager la clé entre texte et tableaux retourne 409 idempotency_conflict. Un changement de format de la même opération conserve la clé et l’image. Voir idempotence et tarifs.