Skip to main content
Documentation API

Vue d’ensemble de l’API

Intégrez la reconnaissance de texte et l’extraction de tableaux avec une clé API et un solde communs, facturés à l’usage.

Choisir une API

  • Image vers texte

    Extrayez les documents en Markdown JSON, texte brut JSON ou Word modifiable.

    POST /api/v1/image-to-text
  • Image vers tableau

    Extrayez la structure des tableaux en JSON, CSV ou Excel.

    POST /api/v1/image-to-table

L’API FreeAIOCR reconnaît le texte et extrait les tableaux d’images. Consultez les références ci-dessus pour les entrées et les formats de chaque API.

Démarrage rapide

  1. Vérifiez l’adresse e-mail de votre compte
  2. Créez une clé API dans les paramètres et conservez-la en lieu sûr : elle n’est affichée qu’une fois
  3. Ajoutez $5 au solde API. Toutes les clés partagent ce solde, indépendant des abonnements du site et sans expiration
  4. Envoyez la requête ci-dessous depuis votre serveur après avoir remplacé YOUR_API_KEY et document.png
  5. Vérifiez le texte reconnu, les tokens utilisés et les frais dans la réponse

Authentification

Authorization: Bearer YOUR_API_KEY

Utilisez l’authentification Bearer via HTTPS et conservez la clé sur votre serveur. Les requêtes interorigines depuis un navigateur ne sont pas prises en charge. N’exposez jamais la clé dans du code public.

Première requête

Utilisez POST, une clé Bearer et un seul fichier dans image. Remplacez YOUR_API_KEY et document.png. Laissez cURL définir Content-Type multipart et sa frontière. Seul le paramètre de requête facultatif format est accepté ; aucun champ de formulaire ni réglage du modèle supplémentaire. Appelez depuis votre serveur ; les appels interorigines du navigateur ne sont pas pris en charge. Ne publiez pas 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'

Lire la réponse

Le JSON ci-dessous est un exemple ; le texte et les tokens dépendent de l’image.

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

Réessayer en toute sécurité

En cas d’erreur réseau, réutilisez le même Idempotency-Key et l’image d’origine. Une nouvelle opération exige un nouvel identifiant unique. Ne créez pas d’autre opération tant que le résultat ou le débit précédent reste incertain. Consultez la stratégie de nouvelle tentative.

Ces guides concernent les API texte et tableaux. Consultez chaque référence pour les entrées, formats et erreurs spécifiques.