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
- Vérifiez l’adresse e-mail de votre compte
- Créez une clé API dans les paramètres et conservez-la en lieu sûr : elle n’est affichée qu’une fois
- Ajoutez $5 au solde API. Toutes les clés partagent ce solde, indépendant des abonnements du site et sans expiration
- Envoyez la requête ci-dessous depuis votre serveur après avoir remplacé YOUR_API_KEY et document.png
- 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.