Source: https://ailoot.ai/models/it/cloudflare-clef/
Canonical: https://ailoot.ai/models/it/cloudflare-clef/
Language: it

# Cloudflare: Clef

[Markdown](https://ailoot.ai/models/it/cloudflare-clef/index.md) · [JSON](https://ailoot.ai/models/it/cloudflare-clef/facts.json)

## [Cloudflare: Clef](https://ailoot.ai/models/it/cloudflare-clef/)

Cloudflare Clef è un modello decisionale multimodale da 27 miliardi di parametri per classificazione, verifiche di regole e scelte nei flussi di lavoro degli agenti. Valuta uno stato fornito e domande tipizzate, restituendo probabilità per le alternative ammesse, categorie selezionate e punteggi ponderati. Accetta elementi testuali e visivi senza generare testo.

- [**Ailoot Ultra · System One** `POST /v1/systemone` `cloudflare/clef`](https://ailoot.ai/models/it/cloudflare-clef/#method-0)

Informazioni sul modello

Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.

Cloudflare Clef è il modello denso più grande della famiglia decisionale Clef, derivato dal post-addestramento di Qwen3.8-27B con il suo encoder visivo. Cloudflare combina questa architettura con una testa condivisa per lo schema, che indirizza gli elementi di evidenza alle domande e valuta insieme le opzioni ammesse. Clef legge una situazione e restituisce decisioni circoscritte con probabilità in un unico passaggio in avanti della rete. Il suo output è un risultato di classificazione, anziché testo generato, un rapporto aperto o un comando proposto.

Prepara lo stato e lo schema delle domande come input distinti. Lo stato può essere una stringa o JSON che rappresenta un record, una conversazione, il contenuto di un documento o una situazione applicativa. Le domande sono identificate da nomi stabili, e gli stessi nomi identificano le risposte restituite. Definisci che cosa debba stabilire ciascuna domanda e descrivi le opzioni pertinenti. Un record di assistenza può chiedere quale team debba gestire la richiesta, se l’impatto è urgente e quale criterio di gravità si applica, senza fondere queste decisioni diverse in un’unica categoria vaga.

Una domanda noul restituisce la probabilità che una condizione binaria sia vera. Una domanda choice restituisce un’opzione con nome selezionata, le probabilità delle singole opzioni e la confidenza. Una domanda score usa un elenco ordinato di descrizioni, con indici a partire da zero, e restituisce un punteggio atteso, una legenda e le probabilità. Un punteggio frazionario ha significato perché riassume l’incertezza tra livelli ordinati. Esamina la distribuzione oltre alla risposta selezionata; due opzioni vicine possono rivelare una distinzione che l’input non risolve.

Per le verifiche di regole, includi il testo effettivo della regola e i fatti del record. Un esempio è un flusso di elaborazione documentale con domande che chiedono se il record è completo, quale categoria di verifica si applica e quanto gli elementi disponibili giustificano un’attenzione immediata. Poni domande distinte per condizioni distinte. Una valutazione di conformità del modello dovrebbe rimanere collegata alla regola e agli elementi forniti. Se manca una condizione importante, lo schema e l’applicazione dovrebbero prevedere intenzionalmente come gestire tale incertezza.

Per gli elementi visivi, fornisci un’immagine leggibile e una domanda su una condizione visibile o una categoria definita. Un controllo di qualità di un modulo potrebbe valutarne la leggibilità, la presenza di un’area obbligatoria e quale livello di qualità fornito lo descrive meglio. L’interfaccia a pesi aperti del produttore accetta anche array di fotogrammi video. Mantieni i fotogrammi in ordine e identifica l’evento da valutare. Uno schema decisionale circoscritto può classificare quel materiale, mentre una richiesta di descrizione narrativa o di nuovi campi arbitrariamente generati appartiene a un tipo diverso di output.

Il riferimento ospitato del produttore indica un contesto di 65.536 token, da una a 64 domande e fino a quattro immagini incorporate. Le immagini PNG, JPEG o WebP hanno un limite di 4 MiB e 16 megapixel ciascuna, con un totale di 8 MiB decodificati; l’intero corpo della richiesta è limitato a 13 MiB e non sono accettati collegamenti remoti alle immagini. Il budget di input include domande e contenuti multimediali. Il testo lungo può essere troncato per rientrare nella finestra, quindi conserva i passaggi decisivi e le etichette delle fonti. Questi limiti descrivono l’interfaccia di immagini ospitata del produttore; l’encoder a pesi aperti ha proprie rappresentazioni per gli input locali.

La pubblicazione di Cloudflare descrive l’addestramento alla valutazione vincolata allo schema e alla calibrazione delle probabilità. Il modello estrae gli elementi pertinenti per le singole opzioni e poi considera le informazioni tra i campi. Ciò può supportare decisioni su diverse domande correlate in un record, ma non rende una probabilità elevata una garanzia che il fatto sottostante sia vero. Valuta record difficili, incompleti e fuori categoria, oltre ai casi semplici. Criteri decisionali utili coprono le situazioni effettivamente incontrate dal flusso di lavoro e rendono esplicite le distinzioni importanti.

Per un flusso di lavoro di un agente, l’output può determinare quale passaggio successivo definito debba essere preso in considerazione. Fornisci l’osservazione corrente e le azioni candidate con descrizioni chiare, poi conserva l’opzione selezionata e le sue probabilità. L’applicazione circostante applica la propria politica d’azione e registra ciò che ha fatto. Mantieni il registro di esecuzione separato dal risultato decisionale: selezionare un percorso di verifica non dimostra che un revisore abbia agito, e selezionare un passaggio diagnostico non dimostra che quel passaggio sia riuscito.

L’artefatto finale è l’oggetto delle risposte, insieme allo stato e allo schema che lo hanno prodotto. Usa questi record per esaminare classificazioni inattese, individuare criteri ambigui e confrontare i risultati con esempi verificati della stessa attività. Se un utente a valle richiede una spiegazione scritta, la decisione e gli elementi originali possono diventare input per una fase separata di scrittura della risposta. Clef fornisce la decisione probabilistica circoscritta necessaria per scegliere la fase successiva, con una descrizione chiara di ciò che è stato valutato.

**Ailoot Ultra · System One** `POST /v1/systemone` `cloudflare/clef`

[`cloudflare/clef`](https://ailoot.ai/models/it/#m=cloudflare%2Fclef&route=Ultra&caller=cloudflare%2Fclef&fmt=systemone)

Cloudflare /`cloudflare/clef`

### Introduzione

Cloudflare Clef è un modello decisionale multimodale da 27 miliardi di parametri per classificazione, verifiche di regole e scelte nei flussi di lavoro degli agenti. Valuta uno stato fornito e domande tipizzate, restituendo probabilità per le alternative ammesse, categorie selezionate e punteggi ponderati. Accetta elementi testuali e visivi senza generare testo.

Input accettati

Testo · Immagini

Risultati

decisions

### Disponibile in Ailoot · input e metodi

**Ailoot Ultra · System One** `POST /v1/systemone`

Tipi di input

`text`, `image`

Tipi di output

`decisions`

Formato di output

json

| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
| --- | --- | --- | --- | --- |
| Campo`model` | Tipo`string` | RequisitoObbligatorio | Valori e limiti cloudflare/clef | Predefinito— |
| Campo`provider` | Tipo`schema` | RequisitoFacoltativo | Valori e limiti | Predefinito— |
| Campo`questions` | Tipo`object` | RequisitoObbligatorio | Valori e limiti | Predefinito— |
| Campo`session_id` | Tipo`string` | RequisitoFacoltativo | Valori e limiti | Predefinito— |
| Campo`state` | Tipo`schema` | RequisitoObbligatorio | Valori e limiti | Predefinito— |
| Campo`trace` | Tipo`schema` | RequisitoFacoltativo | Valori e limiti | Predefinito— |
| Campo`user` | Tipo`string` | RequisitoFacoltativo | Valori e limiti | Predefinito— |
| Campo`questions.<id>.type` | Tipo`string` | RequisitoObbligatorio | Valori e limiti noul, choice, score | Predefinito— |
| Campo`questions.<id>.instructions` | Tipo`string\|object\|array` | RequisitoObbligatorio | Valori e limiti | Predefinito— |
| Campo`questions.<id>.criteria` | Tipo`object\|array` | RequisitoFacoltativo | Valori e limiti Condizioni: choice/score: obbligatori; noul: facoltativo. I criteri di choice sono un oggetto; score è un array con minItems1. | Predefinito— |
| Campo`questions.<id>.criteria.true` | Tipo`string\|object\|array` | RequisitoObbligatorio | Valori e limiti Si applica quando: Oggetto criteria noul fornito | Predefinito— |
| Campo`questions.<id>.criteria.false` | Tipo`string\|object\|array` | RequisitoObbligatorio | Valori e limiti Si applica quando: Oggetto criteria noul fornito | Predefinito— |

Combinazioni di materiali in input

**noul** · Obbligatorio: state, questions.\<id\>.type=noul, questions.\<id\>.instructions

**choice** · Obbligatorio: state, questions.\<id\>.type=choice, questions.\<id\>.instructions, criteria object

**score** · Obbligatorio: state, questions.\<id\>.type=score, questions.\<id\>.instructions, criteria array with minItems1

Parametri e ciclo di vita del metodo

| Parametro | Contratto |
| --- | --- |
| Parametro`content_type` | Contrattoapplication/json |
| Parametro`required` | Contrattomodel, state, questions |
| Parametro`material_types` | Contrattotext, image |
| Parametro`optional_controls` | Contrattoprovider, session\_id, trace, user |
| Parametro`multimodal_input_binding` | ContrattoUsa esclusivamente la rappresentazione esatta dichiarata per lo stato o il documento. La sola capacità del produttore di elaborare immagini non stabilisce una modalità accettata di trasmissione delle immagini specifica del modello. |

Ciclo di vita: `synchronous`

Invia l'ID esatto del modello e conserva l'intera risposta nativa.

### Tariffe

Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.

Modalità rapida

Non specificato Quando è selezionata la modalità rapida

Modalità flex

Non specificato Quando è selezionata la modalità flex

Sforzo massimo di ragionamento

Non specificato Quando lo sforzo massimo di ragionamento usa l'adeguamento predefinito (default)

#### Tariffe Ailoot

#### Prezzi per configurazione

Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.

| Configurazione | Listino delle tariffe | Token di contesto, più di | Token di contesto, fino al limite incluso | Costo |
| --- | --- | --- | --- | --- |
| ConfigurazioneTariffe di base dei token | Listino delle tariffeTariffa base | Token di contesto, più di— | Token di contesto, fino al limite inclusoNessun limite superiore | Costo Input · Token in input **$0.00048** / 1K token Output · Token in output **$0** / 1K token Input · Lettura dalla cache **—** / 1K token Input · Scrittura nella cache **—** / 1K token Input · Scrittura nella cache, 1 ora **—** / 1K token |
| ConfigurazioneFascia 1 di lunghezza della richiesta | Listino delle tariffe— | Token di contesto, più di0 | Token di contesto, fino al limite inclusoNessun limite superiore | Costo Input · Token in input **$0.00048** / 1K token Output · Token in output **$0** / 1K token Input · Lettura dalla cache **—** / 1K token Input · Scrittura nella cache **—** / 1K token Input · Scrittura nella cache, 1 ora **—** / 1K token |

Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. [Come funzionano la prenotazione e l’addebito finale →](https://ailoot.ai/docs/it/billing/reserve/)

### Esempi di richieste

#### Ailoot Ultra · System One

Struttura ufficiale della richiesta conservata; esempio per la documentazioneUsa il materiale effettivo della tua richiesta e conserva il risultato completo

```json
{
  "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."
  }
}
```

```bash
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
```

### Ricevi e salva i risultati

#### Ailoot Ultra · System One

json

##### Conserva tutti i risultati completati

Conserva ogni risposta, file e parte di contenuto restituiti per intero.

Viene conservata ogni risposta associata all'ID della domanda fornito, con il tipo esatto, il valore noul/choice/score, la confidenza, le probabilità e la legenda. L'intero JSON originale viene memorizzato e restituito solo dopo il conguaglio dell'addebito.

##### Se occorre verificare la risposta originale

Conserva l'operazione originale e la risposta completa o parziale; non ripetere POST.

Campi della risposta

| Campo | Tipo |
| --- | --- |
| Campo`model` | Tipostring |
| Campo`id` | Tipostring |
| Campo`provider` | Tipostring |
| Campo`answers.<id>.type` | Tipostring |
| Campo`answers.<id>.noul` | Tiponumber |
| Campo`answers.<id>.choice` | Tipostring |
| Campo`answers.<id>.score` | Tiponumber |
| Campo`answers.<id>.confidence` | Tiponumber |
| Campo`answers.<id>.probabilities` | Tipoobject |
| Campo`answers.<id>.legend` | Tipoobject |
| Campo`usage.input_tokens` | Tipointeger |
| Campo`usage.output_tokens` | Tipointeger |
| Campo`usage.cost` | Tiponumber |

Errori e passaggi successivi

| Risposta | Condizione | Passaggio successivo |
| --- | --- | --- |
| Risposta400 · `invalid_request_error` | CondizioneCampo obbligatorio, rappresentazione o valore non valido | Passaggio successivoCorreggi il campo della richiesta indicato. |

### Alias

#### Alias del modello

**Ailoot Ultra** [`cloudflare/clef`](https://ailoot.ai/models/it/#m=cloudflare%2Fclef&route=Ultra&caller=cloudflare%2Fclef&fmt=systemone)

#### Alias dei percorsi dei metodi

Usa i percorsi dei metodi indicati sopra.

#### ID di chiamata correlati

[`cloudflare/clef`](https://ailoot.ai/models/it/#m=cloudflare%2Fclef&route=Ultra&caller=cloudflare%2Fclef&fmt=systemone)

FAQ · Cloudflare: Clef

Quali input e risultati sono disponibili?

`POST /v1/systemone` · `cloudflare/clef`: `text`, `image` → `decisions`

Quali campi usa la richiesta?

`POST /v1/systemone` · `cloudflare/clef`: `model`, `provider`, `questions`, `session_id`, `state`, `trace`, `user`

Collega Ailoot a Claude Code, OpenCode, Hermes o alla tua applicazione.

## L’azienda e il suo portafoglio di progetti

L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.

## Acquista token con uno sconto.

Sconto con abbonamento per lavoro regolare. Codici fino al 50% sull’acquisto di token.

Abbonamento

Scegli un piano scontato per richieste regolari.

Codice fino al 50%

Inserisci il codice all’acquisto. Il prezzo si aggiorna secondo la promozione.

Spese nella cronologia

Modello, token e importo sono salvati per ogni richiesta.

[Scegli abbonamento](https://ailoot.ai/docs/it/billing/subscriptions/) · [Consulta prezzi dei modelli](https://ailoot.ai/models/it/)

## Collega l’API al prodotto che vendi.

SaaS, app e bot secondo offerta e accordo di licenza Ailoot. Per rivendere, richiedi una licenza reseller.

Applicazione commerciale

Integra generazione di testo, immagini, video e suono nelle funzioni a pagamento.

Licenza reseller

Invia descrizione del progetto e schema di accesso. Richiedi condizioni scritte per uso e rivendita.

Documenti sul sito

Offerta, accordo di licenza e politica sui dati sono disponibili prima della connessione.

[Richiedi licenza reseller](mailto:support@ailoot.ai) · [Offerta e accordo di licenza](https://ailoot.ai/legal/offer?lang=it)

## Ailoot · L’azienda e il suo portafoglio di progetti





Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI.





L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.





Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.
