Recensione dell’API Liquid AI d1: prezzi, visione e limiti

Un sistema che smista le richieste al supporto non deve scrivere un saggio: deve solo scegliere la coda corretta. Liquid AI d1 nasce esattamente per questo tipo di attività, con un prezzo notevole di $0.04 per milione di token in input. Il punto critico è che velocità e risultati di accuratezza dichiarati dal fornitore non bastano a stabilire soglie affidabili sui propri dati.

Cosa introduce il rilascio di d1 del 5 ottobre

Con il rilascio del 5 ottobre, Liquid AI d1 passa da modello decisionale testuale a modello multimodale, capace di ricevere testo, immagini oppure entrambi. L’annuncio di Liquid AI indica l’accesso diretto all’API con il nome modello d1, oltre all’accesso testuale tramite Vercel e OpenRouter. Su questi gateway, il supporto alla visione è ancora in attesa di essere introdotto.

L’annuncio di Liquid AI del 5 ottobre aggiunge gli input immagine, fissa il prezzo a $0.04/M di token in input e indica per le decisioni testuali una latenza tipica di 200–300 ms.

Liquid definisce il modello decisionale come un sistema che riceve uno stato, valuta una o più domande tipizzate e restituisce probabilità anziché testo discorsivo. d1 è quindi un componente pensato per classificazione, instradamento, filtraggio, ranking e controlli di approvazione: non sostituisce un chatbot né un modello per la programmazione.

Il prezzo di Liquid AI d1 è insolito, ma facile da interpretare male

Liquid AI d1 addebita i token in input e non conteggia token generati in output. “Zero token di output” non significa che la richiesta non produca una risposta o che il servizio sia gratuito: vuol dire che l’API restituisce valori decisionali tipizzati senza generare testo in modo autoregressivo.

Il prezzo ufficiale è di $0.04 per milione di token in input. A questa tariffa, un milione di richieste contenenti 500 token fatturabili ciascuna consumerebbe 500 milioni di token in input, con un costo di circa $20, prima dei rincari applicati dai gateway o di eventuali altri costi della piattaforma.

Lo stesso annuncio di Liquid AI specifica che le immagini usano 1.5 token per ogni patch da 32×32 pixel. Un’immagine 1024×1024 contribuisce quindi con 1,536 token in input: 32×32 patch moltiplicate per 1.5 token.

C’è anche un altro dettaglio di fatturazione da considerare. La documentazione di lancio di Liquid indica che ogni domanda viene fatturata come un prompt autonomo, compresi il testo della domanda e le immagini fornite. Porre cinque domande sulla stessa immagine di grandi dimensioni può quindi costare molto più di una sola domanda, anche se una richiesta con più domande può evitare di inviare nuovamente parte dello stato condiviso.

Dove d1 può sostituire un LLM e dove invece no

Liquid AI d1 è una scelta sensata quando l’output può essere definito prima di inviare la richiesta. Un LLM tradizionale resta preferibile se servono spiegazioni, contenuti generati, codice o ragionamenti articolati.

Il vantaggio operativo principale non è soltanto il basso costo dei token. Gli output tipizzati eliminano la necessità di chiedere a un modello conversazionale di produrre JSON, validare gli enum, correggere payload malformati e pagare testo esplicativo che l’applicazione finirebbe per ignorare.

La stessa interfaccia ristretta è però anche il limite più importante. Liquid AI d1 non può spiegare perché abbia assegnato una determinata probabilità, e un numero apparentemente sicuro non equivale automaticamente a una probabilità calibrata sul nuovo dominio.

Una discussione di utenti reali su r/LocalLLaMA non ha rilevato un vantaggio evidente rispetto ai classificatori one-shot per attività di branching semplici. Il commento riguarda la categoria più ampia, non un test specifico di d1, ma individua il confronto corretto: d1 va messo a paragone con un classificatore semplice, non soltanto con un costoso LLM di fascia alta.

Come funziona il contratto dell’API Liquid AI d1

L’API Liquid AI d1 invia uno stato condiviso insieme a una o più domande nominate. Noul gestisce probabilità sì/no, Choice seleziona un’etichetta tra più opzioni e Score valuta una scala ordinata.

Una richiesta minima segue l’endpoint e la struttura del payload mostrati nella documentazione di lancio di Liquid AI:

import requests

payload = {
    "model": "d1",
    "state": "Customer was charged twice for order A-4471 and requests a refund.",
    "questions": {
        "refund_request": {
            "type": "noul",
            "instructions": "Is the customer requesting a refund?"
        },
        "queue": {
            "type": "choice",
            "instructions": "Which team should handle this ticket?",
            "options": ["billing", "technical", "account", "other"]
        }
    }
}

response = requests.post(
    "https://api.liquid.ai/decisions/v1/systemone",
    headers={"Authorization": "Bearer YOUR_LIQUID_API_KEY"},
    json=payload,
    timeout=30,
)
response.raise_for_status()
print(response.json()["answers"])

Per la visione, l’annuncio ufficiale di Liquid AI mostra immagini codificate in base64 inviate nel campo images, insieme a state e questions. Nell’ispezione di una scheda elettronica, per esempio, si può porre una domanda Noul come “Questa scheda presenta un difetto?” e leggere la probabilità restituita nella risposta nominata.

I tipi di domanda predefiniti dell’API sono vincoli utili. Definite con attenzione etichette e livelli di punteggio, mantenete sempre un fallback esplicito come other ed evitate di considerare la probabilità più alta come un’autorizzazione automatica, a meno che non superi una soglia verificata su esempi etichettati.

Le evidenze pubblicate sono promettenti, ma restano dati del fornitore

L’annuncio di Liquid AI del 5 ottobre riferisce che d1 ha eguagliato o superato GPT-6.1 Sol in quattro applicazioni su sei, con un costo da 19 a 200 volte inferiore rispetto a GPT-6.1 Sol e Claude Opus 5.5, oltre a una maggiore velocità in tutte le attività testate. Sono numeri sufficienti per avviare un pilota, ma la metodologia dell’annuncio si basa su una sola esecuzione per modello e applicazione, non su prove indipendenti ripetute.

La metodologia di Liquid include alcune informazioni utili: ogni applicazione è stata eseguita una volta per modello, con fino a otto richieste concorrenti; i costi sono stati calcolati sui prezzi di listino, senza sconti per la cache dei prompt; inoltre, alcune domande sul codice e sessioni di compattazione sono state scritte dopo la definizione della pipeline di d1. Il post non pubblica curve di calibrazione indipendenti, costi degli errori, limiti di richieste o una tabella completa dei risultati grezzi.

Scegliete una singola decisione ripetuta, create un dataset holdout etichettato, confrontate d1 con la regola o il classificatore attuale e analizzate falsi positivi, falsi negativi, latenza e costi alla soglia che l’azienda userebbe davvero. Prima di abilitare decisioni automatiche su cancellazioni, pagamenti, controllo degli accessi o sicurezza, è preferibile instradare il traffico in modalità shadow.

FAQ sull’API Liquid AI d1

Liquid AI d1 è gratuito?

Il rilascio ufficiale del 5 ottobre indica per d1 un prezzo di $0.04 per milione di token in input, senza costi per i token in output. Le tariffe dei gateway o delle piattaforme di terze parti possono differire da quelle dell’API diretta.

d1 può essere eseguito localmente?

Liquid AI non ha annunciato pesi scaricabili per l’attuale modello d1. Il post del 5 ottobre afferma che sono previsti pesi open source per i prossimi modelli decisionali, non che d1 sia disponibile per il deployment locale.

Qual è la finestra di contesto di d1?

L’annuncio di Liquid del 5 ottobre non indica un limite massimo di contesto. In produzione conviene verificare il limite effettivo tramite il provider scelto, senza fare affidamento su vecchie schede presenti nelle directory.

d1 è migliore di un classificatore tradizionale?

Non ci sono ancora abbastanza prove indipendenti per dare una risposta valida in ogni caso. d1 è interessante quando etichette o rubriche cambiano spesso; per un’attività circoscritta con molti dati etichettati, un classificatore stabile ed economico potrebbe restare la scelta migliore.

La regola per decidere

Liquid AI d1 merita un pilota quando una chiamata costosa a un LLM termina con un’etichetta, una probabilità, un instradamento o un punteggio. Il prezzo di $0.04/M di token in input, la latenza dichiarata di 200–300 ms, gli output tipizzati e il nuovo supporto alla visione rendono il test poco costoso.

Il compromesso ancora da risolvere riguarda la calibrazione: d1 può prendere una decisione a basso costo, ma solo i dati etichettati della vostra produzione possono mostrare se la probabilità restituita è abbastanza sicura da guidare un’azione.