Cloudflare: Clef
Cloudflare Clef est un modèle de décision multimodal de 27 milliards de paramètres destiné à la classification, aux vérifications de règles et aux choix dans les processus d’agents. Il évalue un état fourni et des questions typées, puis renvoie les probabilités des alternatives autorisées, les catégories sélectionnées et des scores pondérés. Il accepte des éléments textuels et visuels sans générer de texte.
À propos du modèle
Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.
Cloudflare Clef est le plus grand modèle dense de la famille de décision Clef, issu d’un post-entraînement de Qwen3.8-27B avec son encodeur visuel. Cloudflare associe cette architecture à une tête commune au schéma, qui dirige les éléments probants vers les questions et évalue ensemble leurs options autorisées. Clef lit une situation et renvoie des décisions délimitées avec des probabilités en une seule passe avant. Sa sortie est un résultat de classification, plutôt qu’un texte généré, un rapport libre ou une commande proposée.
Préparez l’état et le schéma des questions comme des entrées distinctes. L’état peut être une chaîne de caractères ou du JSON représentant un dossier, une conversation, le contenu d’un document ou une situation dans une application. Les questions sont associées à des noms stables, et ces mêmes noms identifient les réponses renvoyées. Définissez ce que chaque question doit établir et décrivez les options pertinentes. Un dossier d’assistance peut demander quelle équipe doit traiter la demande, si l’impact est urgent et quel critère de gravité s’applique, sans réunir ces décisions différentes dans une catégorie vague.
Une question noul renvoie la probabilité qu’une condition binaire soit vraie. Une question choice renvoie une option nommée sélectionnée, les probabilités de chaque option et une valeur de confiance. Une question score utilise une liste ordonnée de descriptions dont les indices commencent à zéro, puis renvoie un score attendu, une légende et des probabilités. Un score fractionnaire a un sens, car il résume l’incertitude entre des niveaux ordonnés. Examinez la distribution ainsi que la réponse sélectionnée ; deux options proches peuvent révéler une distinction que l’entrée ne permet pas de trancher.
Pour les vérifications de règles, incluez le texte réel de la règle et les faits du dossier. Un exemple serait un processus de traitement documentaire comportant des questions sur la complétude du dossier, la catégorie de vérification applicable et la mesure dans laquelle les éléments justifient une attention immédiate. Posez des questions distinctes pour des conditions distinctes. Une évaluation de conformité par le modèle doit rester liée à la règle et aux éléments fournis. Si une condition importante manque, le schéma et l’application doivent prévoir délibérément comment gérer cette incertitude.
Pour les éléments visuels, fournissez une image lisible et une question portant sur une condition visible ou une catégorie définie. Un contrôle de qualité d’un formulaire pourrait évaluer sa lisibilité, la présence d’une zone obligatoire et le niveau de qualité qui le décrit le mieux parmi ceux proposés. L’interface aux poids ouverts du fabricant accepte aussi des tableaux d’images vidéo. Gardez les images dans l’ordre et identifiez l’événement à évaluer. Un schéma de décision délimité peut classer ce matériau, tandis qu’une demande de description narrative ou de nouveaux champs arbitrairement générés correspond à un autre type de sortie.
La référence hébergée du fabricant indique un contexte de 65 536 tokens, d’une à 64 questions et jusqu’à quatre images incorporées. Ses images PNG, JPEG ou WebP sont limitées à 4 MiB et 16 mégapixels chacune, avec un total de 8 MiB après décodage ; le corps complet de la requête est limité à 13 MiB, et les liens d’images distants ne sont pas acceptés. Le budget d’entrée comprend les questions et les médias. Un texte long peut être tronqué pour tenir dans la fenêtre ; préservez donc les passages décisifs et les libellés des sources. Ces limites décrivent l’interface d’images hébergée du producteur ; l’encodeur aux poids ouverts possède ses propres représentations d’entrées locales.
La publication de Cloudflare décrit un entraînement à l’évaluation délimitée par un schéma et au calibrage des probabilités. Le modèle extrait les éléments pertinents pour les différentes options, puis prend en compte les informations entre les champs. Cela peut faciliter des décisions portant sur plusieurs questions liées dans un même dossier, sans qu’une probabilité élevée garantisse pour autant la véracité du fait sous-jacent. Évaluez les dossiers difficiles, incomplets et hors catégories, ainsi que les cas simples. Des critères de décision utiles couvrent les situations réellement rencontrées par le processus et rendent explicites les distinctions importantes.
Dans un processus d’agent, la sortie peut déterminer quelle prochaine étape définie doit être envisagée. Fournissez l’observation actuelle et les actions candidates avec des descriptions claires, puis conservez l’option sélectionnée et ses probabilités. L’application environnante applique sa politique d’action et enregistre ce qu’elle a fait. Gardez cette trace d’exécution séparée du résultat de décision : sélectionner une voie de vérification n’établit pas qu’une personne a effectué la vérification, et sélectionner une étape de diagnostic n’établit pas que cette étape a réussi.
L’artefact final est l’objet de réponses, accompagné de l’état et du schéma qui l’ont produit. Utilisez ces éléments pour examiner les classifications inattendues, repérer les critères ambigus et comparer les résultats à des exemples vérifiés de la tâche. Si un utilisateur en aval a besoin d’une explication écrite, la décision et les éléments d’origine peuvent alimenter une étape de rédaction distincte. Clef fournit la décision probabiliste délimitée nécessaire pour choisir l’étape suivante, avec une description claire de ce qui a été évalué.
Ailoot Ultra · System One POST /v1/systemone cloudflare/clef
cloudflare/clefPremiers pas
Cloudflare Clef est un modèle de décision multimodal de 27 milliards de paramètres destiné à la classification, aux vérifications de règles et aux choix dans les processus d’agents. Il évalue un état fourni et des questions typées, puis renvoie les probabilités des alternatives autorisées, les catégories sélectionnées et des scores pondérés. Il accepte des éléments textuels et visuels sans générer de texte.
- Entrées acceptées
- Texte · Images
- Résultats
- decisions
Disponible dans Ailoot · entrées et méthodes
Ailoot Ultra · System One POST /v1/systemone
- Entrée
text,image- Sortie
decisions- Format de sortie
- json
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites cloudflare/clef | Par défaut— |
Champprovider | Typeschema | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champquestions | Typeobject | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Champsession_id | Typestring | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champstate | Typeschema | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Champtrace | Typeschema | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champuser | Typestring | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champquestions.<id>.type | Typestring | ExigenceObligatoire | Valeurs et limites noul, choice, score | Par défaut— |
Champquestions.<id>.instructions | Typestring|object|array | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Champquestions.<id>.criteria | Typeobject|array | ExigenceFacultatif | Valeurs et limites Conditions: choice/score : obligatoire ; noul : facultatif. Les critères de choice forment un objet ; score est un tableau avec minItems1. | Par défaut— |
Champquestions.<id>.criteria.true | Typestring|object|array | ExigenceObligatoire | Valeurs et limites S’applique lorsque: objet de critères noul fourni | Par défaut— |
Champquestions.<id>.criteria.false | Typestring|object|array | ExigenceObligatoire | Valeurs et limites S’applique lorsque: objet de critères noul fourni | Par défaut— |
Combinaisons d’éléments d’entrée
noul · Obligatoire : state, questions.<id>.type=noul, questions.<id>.instructions
choice · Obligatoire : state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Obligatoire : state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, state, questions |
Paramètrematerial_types | Contrattext, image |
Paramètreoptional_controls | Contratprovider, session_id, trace, user |
Paramètremultimodal_input_binding | ContratUtilisez uniquement la représentation exacte déclarée de l’état ou du document. La capacité du fabricant à traiter des images ne suffit pas à établir un format de transport d’image accepté pour le modèle concerné. |
Cycle de vie : synchronous
Envoyez l’identifiant exact du modèle et conservez la réponse native complète.
Tarifs
Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.
- Mode rapide
- Non précisé Lorsque le mode rapide est sélectionné
- Mode Flex
- Non précisé Lorsque le mode flex est sélectionné
- Effort de raisonnement maximal
- Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)
Tarifs Ailoot
Prix par configuration
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Barème tarifaire | Tokens de contexte, plus de | Tokens de contexte, jusqu’à la limite incluse | Coût |
|---|---|---|---|---|
| ConfigurationTarifs de base des tokens | Barème tarifaireTarif de base | Tokens de contexte, plus de— | Tokens de contexte, jusqu’à la limite incluseSans borne supérieure | Coût Entrée · Tokens en entrée $0.00048 / 1K tokens Sortie · Tokens en sortie $0 / 1K tokens Entrée · Lecture du cache — / 1K tokens Entrée · Écriture dans le cache — / 1K tokens Entrée · Écriture dans le cache, 1 h — / 1K tokens |
| ConfigurationPalier 1 de longueur de requête | Barème tarifaire— | Tokens de contexte, plus de0 | Tokens de contexte, jusqu’à la limite incluseSans borne supérieure | Coût Entrée · Tokens en entrée $0.00048 / 1K tokens Sortie · Tokens en sortie $0 / 1K tokens Entrée · Lecture du cache — / 1K tokens Entrée · Écriture dans le cache — / 1K tokens Entrée · Écriture dans le cache, 1 h — / 1K tokens |
Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →
Exemples de requêtes
Ailoot Ultra · System One
{
"model": "cloudflare/clef",
"questions": {
"is_bug": {
"criteria": {
"false": "The customer is asking a question or requesting a feature.",
"true": "The customer describes broken or unexpected product behavior."
},
"instructions": "Is the customer reporting a software defect?",
"type": "noul"
},
"team": {
"criteria": {
"account": "Login, permissions, or profile issues.",
"frontend": "Rendering, layout, or browser compatibility issues.",
"payments": "Checkout, billing, or payment processing issues."
},
"instructions": "Which team should own this ticket?",
"type": "choice"
},
"urgency": {
"criteria": [
"Can wait for the next release",
"Should be fixed this week",
"Blocking revenue right now"
],
"instructions": "How urgent is this ticket?",
"type": "score"
}
},
"state": {
"customer_tier": "enterprise",
"ticket": "My checkout page shows a blank screen after I click Pay. I have tried two browsers."
}
}set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='cloudflare/clef'
Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/systemone \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT
Recevoir et enregistrer les résultats
Ailoot Ultra · System One
json
Conserver tous les résultats terminés
Conservez chaque réponse, fichier et partie de contenu renvoyés dans leur intégralité.
Chaque réponse fournie pour un identifiant de question est conservée avec son type exact, sa valeur noul/choice/score, son niveau de confiance, ses probabilités et sa légende. L’intégralité du JSON d’origine est enregistrée et renvoyée uniquement après la facturation définitive.
Si la réponse d’origine doit être vérifiée
Conservez l’opération d’origine et la réponse complète ou partielle ; ne répétez pas le POST.
Champs de la réponse
| Champ | Type |
|---|---|
Champmodel | Typestring |
Champid | Typestring |
Champprovider | Typestring |
Champanswers.<id>.type | Typestring |
Champanswers.<id>.noul | Typenumber |
Champanswers.<id>.choice | Typestring |
Champanswers.<id>.score | Typenumber |
Champanswers.<id>.confidence | Typenumber |
Champanswers.<id>.probabilities | Typeobject |
Champanswers.<id>.legend | Typeobject |
Champusage.input_tokens | Typeinteger |
Champusage.output_tokens | Typeinteger |
Champusage.cost | Typenumber |
Erreurs et étapes suivantes
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionChamp obligatoire, représentation ou valeur invalide | Étape suivanteCorrigez le champ indiqué dans la requête. |
Alias
Alias du modèle
Ailoot Ultra cloudflare/clef
Alias des chemins de méthode
Utilisez les chemins de méthode indiqués ci-dessus.
ID d’appel associés
FAQ · Cloudflare: Clef
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/systemone·cloudflare/clef:text,image→decisions- Quels champs la requête utilise-t-elle ?
POST /v1/systemone·cloudflare/clef:model,provider,questions,session_id,state,trace,user