Choisir un modèle
Comparez Jev, Clef Flash, Clef Omni et Clairic, et sachez quand changer.
Un modèle est la partie de System One qui évalue votre contexte et répond à vos questions. Des modèles différents peuvent donner des résultats différents pour la même tâche. Un prix plus élevé ne garantit pas une meilleure réponse pour votre usage.
Prêt pour les questions
Quels modèles System One propose-t-il ? Jev, Clef, Clef Flash, Clef Omni et Clairic.
Clairic ou Clef Flash ? Clairic pour l’extraction de champs typés ; Clef Flash pour des décisions Choice, Score et Noul rapides.
Trouver la sélection actuelle
Ouvrez le répertoire des modèles pour voir les modèles actuellement proposés. Après connexion, le Playground permet de sélectionner un modèle et de l’essayer sur un exemple ou sur votre propre tâche.
La sélection peut grandir et changer. Ce guide explique comment choisir ; ce n’est pas une liste fixe de tous les modèles. Avant d’utiliser un modèle, vérifiez ses informations actuelles dans le produit :
| Ce qu’il faut vérifier | Pourquoi c’est important |
|---|---|
| Nom et identifiant du modèle | Le nom aide à le reconnaître ; l’identifiant exact le désigne dans un autre outil. |
| Entrées et types de questions pris en charge | Vérifiez qu’il accepte le matériel et les questions que vous voulez soumettre. |
| Limites d’entrée | Vérifiez la taille de la requête, le nombre de questions, de choix et de niveaux, et les instructions obligatoires. |
| Prix en crédits | Le modèle sélectionné influe sur le coût de la requête ; vérifiez l’estimation avant d’exécuter. |
N’utilisez que les capacités explicitement offertes par System One pour ce modèle. Si le répertoire ne peut pas être chargé, ne devinez ni identifiant ni prix : réessayez plus tard ou contactez le support.
Images et limites par modèle
Lisez capabilities.inputs pour image et le limits.images correspondant (count, bytesPerImage, totalBytes). Les noms de modèles, les préfixes d’identifiants et les versions du SDK ne donnent pas de capacités. Les entrées de catalogue compatibles avec les images, comme Clef, Clef Flash et Clef Omni, acceptent les images ; les entrées texte seul comme Jev refusent les images non vides. Clairic est un modèle d’extraction, complémentaire de ces modèles de décision ; appelez-le sous le nom public clairic et avec le SDK extract().
Comparer les modèles sur votre tâche
- Choisissez quelques exemples représentatifs, dont un ambigu ou difficile.
- Rédigez des questions claires et des réponses candidates. Voir les types de questions.
- Sélectionnez un modèle dans le Playground. Cliquez sur Model information à côté du sélecteur pour consulter ses limites et son tarif, vérifiez les crédits estimés, puis exécutez la requête.
- Gardez le contexte et les questions identiques, sélectionnez un autre modèle, et vérifiez la nouvelle estimation avant de relancer.
- Comparez les réponses avec vos résultats attendus. Considérez ensemble les erreurs, l’incertitude, le temps écoulé et les crédits.
Chaque exécution est une requête distincte et peut consommer des crédits. Un exemple réussi ne prouve pas qu’un modèle sera toujours correct ou rapide.
Changer de modèle
Après avoir changé de modèle sélectionné, vérifiez à nouveau l’entrée et l’estimation. Un modèle peut exiger plus de choix, des noms de questions plus courts ou des instructions qu’un autre modèle n’exigeait pas.
Si une entrée est rejetée, suivez les limites affichées plutôt que de renvoyer la même requête. Si un modèle n’est plus disponible, choisissez dans le répertoire actuel et testez le remplacement avant de vous y fier.
Sélectionner un modèle dans les requêtes SDK ou HTTP
Copiez l’identifiant exact du modèle depuis le répertoire courant dans le champ model de votre requête. Ne substituez pas le nom d’affichage, un ancien identifiant d’exemple ou une abréviation devinée. Laissez le champ vide pour utiliser le défaut courant du service.
Récupérez le répertoire avec GET /v1/models, qui est public et ne consomme pas de crédits d’inférence. Les identifiants de modèle sont opaques, les alias peuvent changer et le catalogue n’est pas un ensemble figé.
Le prix est un champ du catalogue vivant (pricing.creditsPerBlock). Les valeurs publiées sont de 1 crédit par question et par bloc de 4 Ko pour Jev, 3 pour Clef Flash, 4 pour Clef Omni, 6 pour Clef, et 2 crédits par bloc et par requête pour Clairic. Le catalogue en ligne reste la source de vérité ; vérifiez l’estimation avant d’exécuter.
Changer de modèle crée une tâche différente pour le suivi des reprises : utilisez une nouvelle clé d’idempotence. Si le résultat d’une requête précédente est inconnu, vérifiez-le ou reprenez-le d’abord au lieu de changer de modèle pour réessayer à l’aveugle.