Retour à l'accueil

API de génération

Générez des listes de phrases ou de mots de manière automatique.

Générations

Génération automatique de listes

POSThttps://genlexis.com/v1/generations

Genlexis sélectionne des éléments dans son corpus en fonction des paramètres demandés. Choisissez un tirage purement aléatoire ou un tirage équilibré phonémiquement. La réponse contient les listes obtenues et les paramètres appliqués.

Authentification

Une clé API est requise. Elle est attribuée par l'équipe Genlexis.

Exemple de clé (fictive) glx_0123456789...abcdef
Écrire à l'équipe Genlexis pour obtenir votre clé API

Paramètres

selectionchaîneobligatoire

Mode de sélection, aléatoire ou avec équilibrage phonémique. random · phoneme_balanced

language"fr-FR"obligatoire

Langue du corpus ; seule fr-FR est disponible actuellement.

patternchaîneobligatoire

Patron grammatical des éléments à sélectionner. noun · det_noun · det_noun_adj · np_verb

listCountentierobligatoire

Nombre de listes à produire. Valeurs : 1 à 5

itemsPerListentierobligatoire

Nombre d'éléments souhaité dans chaque liste. Valeurs : 1 à 50

filtersobjetfacultatif

Contraintes facultatives appliquées aux éléments du corpus.

Voir les 6 champs
detTypechaînefacultatif

Type de déterminant ; réservé aux patrons avec déterminant. definite · indefinite

genderchaînefacultatif

Genre grammatical du nom. m · f

grammNumberchaînefacultatif

Nombre grammatical du nom. s · p

lengthentierfacultatif

Longueur exacte du nom dans l'unité choisie. Valeurs : 1 à 20

lengthUnitchaînefacultatif

Unité de longueur ; nécessite length. Par défaut, syllabes. syllables · phonemes

lexicalDensitychaînefacultatif

Niveau de densité lexicale demandé pour le nom. high · medium · low

seedchaînefacultatif

Graine de tirage ; créée si elle est omise. Le résultat reste reproductible tant que le corpus et les règles ne changent pas. Longueur : 1 à 128

allowPartialbooléenfacultatif

Autorise le retour des éléments disponibles si la demande ne peut pas être remplie ; un résultat vide reste refusé. Par défaut : false

Réponse

selectionchaîneobligatoire

Mode de sélection utilisé pour ce résultat. random · phoneme_balanced

language"fr-FR"obligatoire

Langue des éléments sélectionnés.

seedchaîneobligatoire

Graine effectivement utilisée pour cette génération.

optionsobjetobligatoire

Paramètres appliqués à cette génération.

Voir les 5 champs
patternchaîneobligatoire

Patron grammatical appliqué.

listCountentierobligatoire

Nombre de listes demandé.

itemsPerListentierobligatoire

Nombre d'éléments demandé par liste.

filtersobjetobligatoire

Filtres appliqués.

Voir les 6 champs
detTypechaînefacultatif

Type de déterminant ; réservé aux patrons avec déterminant. definite · indefinite

genderchaînefacultatif

Genre grammatical du nom. m · f

grammNumberchaînefacultatif

Nombre grammatical du nom. s · p

lengthentierfacultatif

Longueur exacte du nom dans l'unité choisie. Valeurs : 1 à 20

lengthUnitchaînefacultatif

Unité de longueur ; nécessite length. Par défaut, syllabes. syllables · phonemes

lexicalDensitychaînefacultatif

Niveau de densité lexicale demandé pour le nom. high · medium · low

allowPartialbooléenobligatoire

Indique si les résultats partiels étaient autorisés.

listsobjet[][]obligatoire

Listes produites ; chaque élément contient un identifiant, un texte et son patron grammatical.

requestedItemsentierobligatoire

Nombre total d'éléments demandés. Valeurs : 1 à +∞

totalItemsentierobligatoire

Nombre total d'éléments retournés. Valeurs : 1 à +∞

completebooléenobligatoire

Indique si tous les éléments demandés ont été retournés.

scoresnombre[]facultatif

Distance phonémique de chaque liste ; présente seulement en mode phoneme_balanced.

aggregateScorenombrefacultatif

Moyenne des distances phonémiques des listes produites. Valeurs : 0 à +∞

poolSizeentierfacultatif

Nombre d'éléments du corpus considérés pour l'équilibrage phonémique. Valeurs : 0 à +∞

Erreurs

200Génération complète ou résultat partiel explicitement autorisé.
400Code d'erreur stable accompagné d'un message explicatif.
401Code d'erreur stable accompagné d'un message explicatif.
403Code d'erreur stable accompagné d'un message explicatif.
422Code d'erreur stable accompagné d'un message explicatif.
503Code d'erreur stable accompagné d'un message explicatif.
fren