Cloudflare: Clef Omni
Cloudflare Clef Omni est un modèle de décision multimodal reposant sur un socle MoE de 30B paramètres au total, dont 3B actifs. Il évalue le texte, l’état structuré et les médias fournis au regard de questions typées, et renvoie des probabilités ainsi que des décisions bornées. Sa sortie est un choix, une probabilité de vrai ou un score ordonné, et non une prose générée.
À 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 Omni est le modèle multimodal à mélange d’experts de la famille de modèles de décision Clef. Il est issu d’un post-entraînement du socle de compréhension Qwen3-Omni-30B-A3B-Instruct, avec 30B paramètres au total et 3B paramètres actifs. Cloudflare y ajoute une tête de schéma conjointe qui achemine les éléments probants vers les questions demandées et note ensemble leurs options autorisées. Le résultat est une décision typée assortie de probabilités, et non une explication, une transcription ou une sortie vocale générée.
Préparez deux parties principales : un état décrivant la situation et un mappage de questions nommées. L’état peut être du texte ou du JSON structuré, et les entrées natives du modèle comprennent également des images, de l’audio et de la vidéo. Chaque question indique ce qu’il faut décider et quelles réponses sont autorisées. Gardez des identifiants stables afin qu’une application puisse associer chaque réponse renvoyée à la question d’origine. Des descriptions d’options claires donnent tout son sens à une catégorie ; à défaut, une étiquette courte et ambiguë peut masquer la distinction dont le flux de travail a réellement besoin.
Le format d’enregistrement comprend trois types de questions. Une question noul porte sur une condition vrai/faux et renvoie la probabilité de vrai. Une question de choix définit des options nommées et renvoie l’option sélectionnée, les probabilités par option et une valeur de confiance distincte. Une question de score définit des critères ordonnés indexés à partir de zéro et renvoie un score pondéré par les probabilités, une légende et des probabilités. Le score peut être fractionnaire, car il reflète une distribution sur les différents niveaux. Une décision est donc plus riche qu’une simple étiquette, tout en restant bornée par le schéma fourni.
Pour un examen visuel, fournissez une image nette et la condition à évaluer. Prenons l’exemple d’un dossier d’installation dont les questions demandent si l’étiquette d’identification est visible, laquelle des catégories d’état définies s’applique et si les éléments sont suffisants pour un examen. Séparez les observations : la visibilité d’une étiquette est une question différente de l’aspect achevé d’une installation. La sortie peut aider une application à acheminer le dossier ou à signaler une condition d’examen ; elle ne réalise pas elle-même d’inspection, ne modifie pas de dossier et ne génère pas de rapport écrit.
Pour l’audio et la vidéo, concentrez les questions sur les éléments que l’extrait fourni peut étayer. Un examen pratique d’équipement peut comprendre une photo, un enregistrement et une courte vidéo, et demander si un son précis est présent ou si un composant bouge visiblement. Le fabricant indique traiter la bande son d’une vidéo en même temps que ses trames lorsque toutes les vidéos du dossier comportent du son. Préservez le lien entre les médias et l’état écrit, et évitez de demander au modèle de classer un événement situé en dehors de l’intervalle joint.
Le profil hébergé du fabricant indique un contexte de 64 000 jetons et d’une à 64 questions. Il accepte jusqu’à quatre images, quatre extraits audio et deux vidéos, les extraits audio étant limités à 300 secondes chacun et les vidéos à 60 secondes chacune. Ce sont les limites de l’interface documentée du producteur. Les médias et les questions occupent du contexte ; un excès de médias peut faire échouer la requête, tandis qu’un long état textuel peut être tronqué pour tenir dans la fenêtre. Placez les éléments décisifs dans un dossier ciblé et préparez les questions avant de consacrer la fenêtre à un historique sans rapport.
L’interface hébergée du fabricant reçoit des médias intégrés plutôt que des liens distants. Ses images PNG, JPEG ou WebP sont limitées à 4 MiB et 16 mégapixels chacune, avec un budget total de 8 MiB d’images décodées. Chaque extrait audio est limité à 8 MiB et 300 secondes ; chaque vidéo à 16 MiB et 60 secondes. L’audio et la vidéo réunis peuvent totaliser au plus 16 MiB décodés, et les vidéos sont échantillonnées à deux images par seconde. Ces limites relèvent de cette interface du producteur ; l’encodeur à poids ouverts accepte d’autres représentations locales. La capacité audio du socle de compréhension ne signifie pas que ce modèle de décision produit de l’audio : ses composants de génération vocale ne sont pas utilisés pour la notation des décisions.
Pour le support ou l’acheminement dans un flux de travail, définissez les catégories et les critères ordonnés à partir des règles opérationnelles réelles. Un dossier de ticket peut demander quelle équipe doit le traiter, si l’impact est urgent et quel niveau de gravité correspond le mieux aux éléments. La sortie observable est un ensemble de réponses typées sous ces noms de questions. Examinez l’ensemble de la distribution de probabilités lorsque des catégories sont proches, et définissez explicitement la manière dont l’application traite les cas incertains. Une probabilité élevée est une évaluation par le modèle des éléments fournis, et non la preuve que la condition a été vérifiée de manière indépendante.
Conservez ensemble l’état, le schéma des questions et les réponses renvoyées lorsque vous examinez un résultat. Vérifiez si les options couvrent la situation réelle, si leurs descriptions se chevauchent et si des éléments importants ont été omis ou tronqués. Si une étape en aval a besoin d’une explication écrite, elle peut utiliser la décision et les éléments sources comme entrée d’une étape de rédaction distincte. Le rôle utile de Clef Omni est de noter des alternatives définies à partir d’éléments multimodaux, afin que l’action suivante puisse être choisie avec une entrée et une sortie claires et vérifiables.
Ailoot Ultra · System One POST /v1/systemone cloudflare/clef-omni
cloudflare/clef-omniPremiers pas
Cloudflare Clef Omni est un modèle de décision multimodal reposant sur un socle MoE de 30B paramètres au total, dont 3B actifs. Il évalue le texte, l’état structuré et les médias fournis au regard de questions typées, et renvoie des probabilités ainsi que des décisions bornées. Sa sortie est un choix, une probabilité de vrai ou un score ordonné, et non une prose générée.
- Entrées acceptées
- Texte · Images
- Résultats
- decisions
Disponible dans Ailoot · entrées et méthodes
Ailoot Ultra · System One POST /v1/systemone
- Types d’entrée
text,image- Types de sortie
decisions- Format de sortie
- json
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites cloudflare/clef-omni | 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 : obligatoires ; noul : facultatif. Les critères de choice forment un objet ; score est un tableau avec minItems égal à 1. | 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 seule capacité du fabricant à traiter des images ne prouve pas l’existence d’un format d’entrée image accepté pour ce modèle. |
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.0003 / 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.0003 / 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-omni",
"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-omni'
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 degré 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 le règlement.
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 rejouez 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 non valide | Étape suivanteCorrigez le champ de requête indiqué. |
Alias
Alias du modèle
Ailoot Ultra cloudflare/clef-omni
Alias des chemins de méthode
Utilisez les chemins de méthode indiqués ci-dessus.
ID d’appel associés
FAQ · Cloudflare: Clef Omni
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/systemone·cloudflare/clef-omni:text,image→decisions- Quels champs la requête utilise-t-elle ?
POST /v1/systemone·cloudflare/clef-omni:model,provider,questions,session_id,state,trace,user