OCR (texte d’un document)

POST /v1/ocr renvoie le texte d’un PDF ou d’une image, page par page, en Markdown. Une page qui a déjà une couche de texte (un PDF exporté depuis un traitement de texte) est lue directement ; une page scannée ou une photo est lue par reconnaissance de caractères.

POST https://api.realmoon.ai/v1/ocr

• Authentification : clé sk-moon-… avec la portée inference (voir Authentification).
• Corps : multipart/form-data (avec l’en-tête Content-Length) ou JSON, dans la forme de l’API OCR de Mistral.
• Réponse : le texte de chaque page lue.

Le seul modèle est moon-ocr-1. Il tourne sur nos serveurs en France : le document n’est envoyé à aucun fournisseur et n’est pas gardé une fois la réponse donnée.

Paramètres#Lien vers la section Paramètres

En multipart#Lien vers la section En multipart

En JSON#Lien vers la section En JSON

En JSON, tout autre paramètre est refusé avec 400 unknown_parameter.

Pages#Lien vers la section Pages

• Sans pages, tout le document est lu, jusqu’à 50 pages. Au-delà, l’API répond 400 too_many_pages : choisissez les pages, et faites plusieurs requêtes pour un long document.
• Une image a une seule page, la page 0.
• Une page déjà demandée n’est lue qu’une fois.

Exemple#Lien vers la section Exemple

Les SDK d’OpenAI n’ont pas de méthode pour ce point d’accès : appelez-le en HTTP.

curl https://api.realmoon.ai/v1/ocr \
  -H "Authorization: Bearer $MOONAI_API_KEY" \
  -F model=moon-ocr-1 \
  -F file=@facture.pdf \
  -F pages=0,1

import os
import requests

with open("facture.pdf", "rb") as document:
    response = requests.post(
        "https://api.realmoon.ai/v1/ocr",
        headers={"Authorization": f"Bearer {os.environ['MOONAI_API_KEY']}"},
        data={"model": "moon-ocr-1", "pages": "0,1"},
        files={"file": ("facture.pdf", document, "application/pdf")},
        timeout=100,
    )
response.raise_for_status()
for page in response.json()["pages"]:
    print(page["index"], page["source"])
    print(page["markdown"])

import fs from 'node:fs';

const form = new FormData();
form.append('model', 'moon-ocr-1');
form.append('pages', '0,1');
form.append('file', new Blob([fs.readFileSync('facture.pdf')], { type: 'application/pdf' }), 'facture.pdf');

const response = await fetch('https://api.realmoon.ai/v1/ocr', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.MOONAI_API_KEY}` },
  body: form,
});
const result = await response.json();
for (const page of result.pages) console.log(page.index, page.source, page.markdown);

Le même appel en JSON, avec le document en base64 :

curl https://api.realmoon.ai/v1/ocr \
  -H "Authorization: Bearer $MOONAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"model\": \"moon-ocr-1\", \"document\": {\"type\": \"document_url\", \"document_url\": \"data:application/pdf;base64,$(base64 -w0 facture.pdf)\"}, \"pages\": [0, 1]}"

Réponse#Lien vers la section Réponse

{
  "model": "moon-ocr-1",
  "pages": [
    {
      "index": 0,
      "markdown": "# Facture n° 2026-118\n\nDate : 4 novembre 2026\n\n| Désignation | Montant |\n| --- | --- |\n| Prestation | 1 200,00 € |",
      "source": "text",
      "images": [],
      "dimensions": null
    },
    {
      "index": 1,
      "markdown": "Conditions de paiement : 30 jours.",
      "source": "ocr",
      "images": [],
      "dimensions": null
    }
  ],
  "usage_info": { "pages_processed": 2, "doc_size_bytes": 184320 },
  "usage": { "pages": 2, "pages_not_read": 0, "credits": 0 }
}

La valeur de credits est fictive.

Coûts#Lien vers la section Coûts

Le prix est fixe par page lue ; il figure dans GET /v1/models?type=ocr (pricing.credits_per_unit, billing: flat) et dans l’onglet « Modèles » du portail. La requête retient le prix des pages demandées, puis ne facture que les pages réellement lues. Un document illisible ou une requête qui échoue ne coûte rien.

Limites#Lien vers la section Limites

Le service de lecture est partagé : quand il est occupé par d’autres requêtes, l’API répond 429 too_many_concurrent ou 503 ocr_busy. Pour un gros document, envoyez quelques pages à la fois et lancez les requêtes l’une après l’autre.

Erreurs#Lien vers la section Erreurs

Les erreurs de clé, de solde et de plafonds sont dans Erreurs.

Voir aussi#Lien vers la section Voir aussi

• Confidentialité : ce que Moon AI garde, et ne garde pas, d’un document.
• Modèles : les champs max_pages et max_file_mb.