ForHosting KIT · Éducation

Niveau scolaire du texte par longueur

Trois phrases courtes de 16 mots et 17 syllabes se situent sous la première année, au tout début du primaire. Collez un texte en anglais et voyez son niveau scolaire approximatif, calculé d'après la longueur des phrases et les syllabes par mot. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Rédacteurs, enseignants et concepteurs de programmes ont souvent besoin d’une réponse rapide à une question simple : à peu près quel niveau scolaire peut lire ce passage sans effort excessif ? Cet estimateur de niveau de lecture accepte un passage en anglais, compte les phrases, les mots et les syllabes avec une heuristique fixe, et renvoie un niveau de grade scolaire américain approximatif fondé sur la longueur moyenne des phrases et la moyenne de syllabes par mot — les mêmes ingrédients structurels que la formule classique Flesch–Kincaid Grade Level. Utilisez le score comme signal transparent de longueur et de complexité, non comme affirmation sur la rareté du vocabulaire ou la difficulté thématique.

Comment le niveau se déduit d’heuristiques de longueur

Le niveau scolaire ici n’est ni un jugement éditorial subjectif ni un classifieur d’apprentissage automatique. C’est une estimation à forme fermée à partir de deux statistiques de surface qui corrèlent avec la demande de lecture en prose anglaise : la longueur typique des phrases et le nombre de noyaux syllabiques que chaque mot tend à porter. La longueur moyenne de phrase (ASL) est le nombre de jetons de mots alphabétiques divisé par le nombre d’unités de phrase.

Les unités sont produites en scindant sur la ponctuation terminale telle que le point, le point d’interrogation et le point d’exclamation ; si le passage n’a aucune marque terminale, tout le texte trimé compte pour une seule phrase afin que le rapport reste défini. La moyenne de syllabes par mot (ASW) est le total de syllabes divisé par le nombre de mots.

Les syllabes sont estimées par une heuristique déterministe de groupes vocaliques anglais : les voyelles consécutives forment un noyau, un e muet final est en général omis pour les mots plus longs, et chaque jeton alphabétique contribue au moins une syllabe. La formule de grade est l’identité publique Flesch–Kincaid Grade Level : zéro virgule trois neuf fois ASL plus onze virgule huit fois ASW moins quinze virgule cinq neuf, avec les coefficients 0.39, 11.8 et 15.59.

Des phrases plus longues et davantage de mots polysyllabiques poussent le score vers le haut ; des clauses courtes et une diction monosyllabique le tirent vers les bandes du début du primaire. La réponse borne aussi le score continu dans une plage d’affichage pratique et le mappe vers une étiquette de bande grossière telle que elementary, middle school, high school ou college, afin que les interfaces montrent un libellé en langage clair à côté du grade numérique sans inventer leurs propres seuils.

Cas d’usage

Alignement classe et fiches d’exercices

Collez des brouillons de passages et vérifiez que le niveau estimé reste proche de l’année scolaire cible avant d’imprimer les supports.

Contrôles de politique de langage clair

Scorez des avis publics et des articles d’aide pour signaler les brouillons qui dépassent la bande collège ou lycée autorisée.

Questions fréquentes

Le niveau de grade est-il exact pour chaque lecteur ?

Non. C’est une estimation structurelle approximative à partir d’heuristiques de longueur. Elle ne modélise ni le vocabulaire rare, ni les connaissances préalables, ni la morphologie non anglaise. Utilisez-la comme signal transparent en plus de la relecture humaine.

En quoi cela diffère-t-il d’une suite complète de lisibilité ?

Cette capacité se concentre sur le niveau scolaire approximatif à partir de ASL et ASW. Les outils multi-métriques peuvent aussi renvoyer des scores de facilité ou d’autres indices ; l’intention de recherche ici est le grade par longueur pour l’éducation et le langage clair.

Quelle formule l'estimation utilise-t-elle ?

Celle de Flesch–Kincaid : 0,39 fois le nombre moyen de mots par phrase, plus 11,8 fois le nombre moyen de syllabes par mot, moins 15,59. Des phrases et des mots plus longs font monter le niveau.

Pourquoi mon texte obtient-il un niveau négatif ?

Des phrases très courtes faites de mots d'une syllabe font passer le résultat sous zéro. L'exemple sur un chat, une journée ensoleillée et des oiseaux donne -0,9725, ce qui signifie simplement début du primaire.

Puis-je analyser un texte qui n'est pas en anglais ?

L'outil est conçu pour la prose anglaise. Les syllabes sont comptées selon les groupes de voyelles de l'anglais et la formule a été pensée pour cette langue, il ne convient donc qu'aux textes en anglais.

Outils associés

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/edu/reading-level-grade

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/edu/reading-level-grade \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"The cat sat on the mat. It was a sunny day. Birds sang in the trees."}'

const res = await fetch("https://api.kit.forhosting.com/edu/reading-level-grade", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "The cat sat on the mat. It was a sunny day. Birds sang in the trees."
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/edu/reading-level-grade",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "The cat sat on the mat. It was a sunny day. Birds sang in the trees."
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/reading-level-grade", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"The cat sat on the mat. It was a sunny day. Birds sang in the trees."}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"The cat sat on the mat. It was a sunny day. Birds sang in the trees."}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/reading-level-grade", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "text": "The cat sat on the mat. It was a sunny day. Birds sang in the trees."
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "edu.reading_level_grade",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Notes techniques

Le parcours gratuit dans le navigateur et l’API payante partagent un seul module analytique pur, de sorte que les contrôles de devoirs, les plugins LMS et les tableaux de bord éditoriaux ne divergent jamais sur la même entrée. Un texte vide et les chaînes sans mots alphabétiques échouent avec invalid_input et ne sont pas facturés.

Contrat d’entrée, champs de réponse et erreurs de validation

Les passages sans mots alphabétiques (par exemple uniquement des chiffres ou de la ponctuation) échouent aussi car ASL et ASW seraient indéfinis ou dénués de sens. Les entrées extrêmement longues au-delà du plafond de caractères documenté sont rejetées plutôt que partiellement scorées. Exemple : un court passage de premier lecteur avec des phrases brèves et des mots surtout monosyllabiques score près des grades du primaire bas, tandis qu’une prose académique avec de longues clauses imbriquées et des termes polysyllabiques s’oriente vers high school ou college. L’échec de validation n’est pas facturé. Envoyez en POST un corps JSON avec un champ chaîne obligatoire nommé text : le passage anglais à scorer. Les alias passage, content, body et input_text sont acceptés par le solver pour brancher d’anciens formulaires. La valeur doit être une chaîne non vide après suppression des espaces ; nombres purs, objets et chaînes vides échouent avec invalid_input en nommant le champ text. En cas de succès le corps inclut word_count, sentence_count et syllable_count pour auditer les totaux intermédiaires ; avg_sentence_length et avg_syllables_per_word arrondis pour des clients stables ; grade_level comme score continu Flesch–Kincaid arrondi ; grade_level_clamped dans une plage éducative fixe ; grade_band comme étape scolaire en snake_case ; les chaînes formula et method documentant l’identité ; et un court message lisible résumant ASL, ASW et le grade estimé.

Où une API de grade par longueur trouve sa place

Les équipes de supports de classe utilisent une calculatrice de niveau de lecture pour aligner les fiches sur les années cibles avant impression. Les programmes d’accessibilité et de langage clair surveillent si les avis publics dépassent la bande de grade autorisée par leur politique, sans payer au jeton un modèle génératif de réécriture lorsqu’ils n’ont besoin que d’un score structurel. Les flux d’édition bloquent les brouillons de blog qui dépassent un seuil de grade choisi et laissent la réécriture stylistique aux éditeurs humains ou à une capacité distincte de réécriture CEFR lorsque la paraphrase complète est requise. Associez-la à des estimations de temps de lecture ou à des tableaux de lisibilité multi-métriques quand vous avez besoin de durée ou d’indices concurrents ; gardez ce endpoint lorsque la question produit est précisément le grade scolaire approximatif à partir de la longueur de phrase et de la densité syllabique.

Cas d'intégration

Automatisation CMS et éditoriale

Appelez l’API depuis un pipeline de contenu pour étiqueter les articles avec grade_level et grade_band sans exécuter un modèle génératif.

Questions techniques

Comment le niveau de lecture est-il calculé à partir du texte ?

L’API compte les mots, les phrases et les syllabes, puis applique grade = 0.39×(words/sentences) + 11.8×(syllables/words) − 15.59, la formule Flesch–Kincaid Grade Level fondée sur la longueur moyenne des phrases et la moyenne de syllabes par mot.

Quelle entrée la calculatrice de niveau de grade du texte exige-t-elle ?

Envoyez une chaîne anglaise non vide dans le champ text (alias : passage, content, body, input_text). Les chaînes vides et le texte sans mots alphabétiques échouent avec invalid_input et ne sont pas facturés.

Combien coûte l’estimateur de niveau de lecture ?

L’outil navigateur est gratuit. Les requêtes API utilisent le solde prépayé KIT à $0.002 par appel réussi ; une entrée invalide n’est pas facturée.

Consulter la documentation complète du KIT →

Lancer gratuitement