Aller au contenu
API v1 — Bêta publique

API Reo Tahiti AI

Infrastructure ouverte pour la préservation du Reo Tahiti. Intégrez la traduction, le dictionnaire et la correction orthographique directement dans vos applications.

CommencerLimites

URL de base

text
https://reo-tahiti-ai.vercel.app

Toutes les requêtes doivent être effectuées en HTTPS. Les requêtes HTTP sont redirigées automatiquement.

POST/api/translate

Traduit un texte entre le français et le Reo Tahiti à l'aide du système RAG (Cohere + DeepSeek V3). Retourne la traduction, les sources du corpus et le temps de réponse.

Corps de la requête (JSON)

ParamètreTypeDescription
textstringLe texte à traduire (max 5 000 caractères).
direction"fr_to_reo" | "reo_to_fr"Sens de la traduction. Si omis, la direction est détectée automatiquement.

Exemple de requête

bash
curl -X POST https://reo-tahiti-ai.vercel.app/api/translate \
  -H "Content-Type: application/json" \
  -d '{"text": "Bonjour, comment allez-vous ?", "direction": "fr_to_reo"}'

Exemple de réponse

json
{
  "translation": "Ia ora na, eaha to oe huru ?",
  "direction": "fr_to_reo",
  "sources": [
    {
      "title": "Dictionnaire tahitien-français",
      "excerpt": "ia ora na — salutation traditionnelle...",
      "score": 0.94
    }
  ],
  "response_time_ms": 1240
}
GET/api/dictionary

Recherche un mot dans le corpus lexical du Reo Tahiti. Supporte quatre modes de recherche : exact, préfixe, fuzzy et reverse (français → Reo).

Paramètres de requête

ParamètreTypeDescription
qstringLe terme à rechercher.
mode"prefix" | "exact" | "fuzzy" | "reverse"Mode de recherche. Par défaut : prefix.

Exemple de requête

bash
curl "https://reo-tahiti-ai.vercel.app/api/dictionary?q=ia+ora+na&mode=exact"

Exemple de réponse

json
{
  "results": [
    {
      "word": "ia ora na",
      "definition": "Salutation ; bonjour, bonsoir.",
      "examples": ["Ia ora na ! E haere ana oe ihea ?"],
      "category": "salutation",
      "score": 1.0
    }
  ]
}
POST/api/spellcheck

Analyse un texte en Reo Tahiti et retourne les corrections orthographiques suggérées, avec la position de chaque erreur et les alternatives proposées.

Corps de la requête (JSON)

ParamètreTypeDescription
textstringLe texte en Reo Tahiti à analyser (max 1000 caractères).

Exemple de requête

bash
curl -X POST https://reo-tahiti-ai.vercel.app/api/spellcheck \
  -H "Content-Type: application/json" \
  -d '{"text": "ia ora nna, mauru uru roa"}'

Exemple de réponse

json
{
  "corrections": [
    {
      "original": "nna",
      "suggestion": "na",
      "offset": 9,
      "length": 3,
      "confidence": 0.98
    },
    {
      "original": "mauru uru",
      "suggestion": "māuruuru",
      "offset": 14,
      "length": 9,
      "confidence": 0.91
    }
  ]
}
GET/api/stats

Retourne les statistiques du corpus Reo Tahiti AI : nombre de documents, chunks d'indexation, mots uniques et sources disponibles.

Exemple de requête

bash
curl "https://reo-tahiti-ai.vercel.app/api/stats"

Exemple de réponse

json
{
  "documents": 1200,
  "chunks": 1490,
  "words": 70000,
  "sources": [
    "Dictionnaire tahitien-français (Académie Tahitienne)",
    "Bible en Reo Tahiti",
    "Corpus INALCO-LACITO",
    "Fare Vānaʻa — Textes officiels"
  ]
}

Accès

Bêta publique, sans clé

L'API est ouverte en bêta publique : aucune clé ni authentification n'est demandée. Les appels se font directement sur https://reo-tahiti-ai.vercel.app.

Besoin d'un volume plus important (institution, école, entreprise) ? Écrivez à contact@pacifikai.com. Les projets de préservation linguistique bénéficient d'un accès gratuit étendu.

Limites

Ce qui est compté, et ce que renvoie l'API au-delà

  • Traduction (/api/translate) : 100 traductions par jour et par adresse IP, remises à zéro à minuit UTC ; 5 000 caractères maximum par texte.
  • Documents (/api/translate-document) : chaque ligne traduite compte une traduction, sur le même quota ; 10 Mo et 200 lignes maximum.
  • Correcteur (/api/spellcheck) : 1 000 caractères maximum par texte.
  • Dictionnaire, quiz, mot du jour, statistiques : sans quota.

Quota atteint : réponse 429 avec un corps JSON { "error", "remaining", "limit" }. Le quota restant se lit sur GET /api/usage.

Une question ? Un projet ?

Vous travaillez sur un projet de préservation linguistique, d'éducation ou de recherche autour du Reo Tahiti ? Contactez-nous.

jordy@pacifikai.com