Come leggere i nomi dei modelli AI: alias vs versione pinnata

Apri una qualsiasi pagina di API AI e incontri nomi come deepseek-flash, deepseek-v4-pro o DeepSeek-V4-Flash-0731. Sembrano etichette, ma la stringa che inserisci nel campo model decide quale modello risponde e quanto ti viene addebitato. Questa guida mostra come leggere questi nomi, perché lo stesso nome può cambiare sotto i tuoi occhi e cosa controllare prima di incollare un id nel codice.

Anatomia di un nome di modello#

Prendi DeepSeek-V4-Flash-0731 e scomponilo in parti:

Due avvertenze. Il suffisso è una convenzione, non una legge: 1017 corrisponde alla data di rilascio di DeepSeek-V4.1-Flash-1017 (17 ottobre 2026), ma verificalo sempre sulla pagina del modello invece di indovinare. E un nome scritto in una pagina di documentazione (DeepSeek-V4-Flash) non è sempre la stringa accettata dall'API (deepseek-v4-flash-0731): il nome visualizzato è per le persone, l'id è per il codice.

Flash e Pro#

Gli sviluppatori di solito pubblicano diversi tier di una stessa generazione. Flash è normalmente il tier più veloce e leggero, pensato per volumi elevati: chat, estrazione, cicli di agenti. Pro è normalmente il tier più grande per compiti più difficili. Queste parole sono marketing dello sviluppatore, quindi non sono confrontabili tra famiglie: un Flash di un'azienda non ha la stessa dimensione di un Flash di un'altra. Ciò che conta è che deepseek-flash e deepseek-v4-pro sono due nomi di modello diversi, quindi controlla la tabella dei prezzi di quello che usi. Se cambi tier, ricontrolla la tabella dei prezzi.

Alias vs versione pinnata#

Esistono due tipi di id, e la differenza è la cosa più importante di questo articolo.

• Alias — un nome che il provider punta a un certo modello e che può ripuntare in seguito. deepseek-flash è un alias: al 22 ottobre 2026, la documentazione di DeepSeek dice che è servito da DeepSeek-V4.1-Flash-1017, e il modo in cui lo chiami è invariato. Domani la stessa stringa può portare a una build più recente.
• Versione pinnata — un id che include la build, come deepseek-v4-flash-0731. Indica una build specifica, quindi le risposte che hai testato ieri dovrebbero provenire dalla stessa build oggi.

Un alias è comodo: ottieni miglioramenti senza modificare il codice. Un id pinnato è prevedibile: utile per test, valutazioni, report e qualsiasi cosa in cui un cambiamento di comportamento ti sorprenderebbe. Nessuno è "migliore"; scegli con consapevolezza.

Lo stesso nome può cambiare sotto di te#

Il cambiamento di DeepSeek dell'ottobre 2026 è un esempio concreto. Secondo la documentazione di DeepSeek, verificata il 22 ottobre 2026:

• deepseek-flash è attualmente servito da DeepSeek-V4.1-Flash-1017;
• i nomi più vecchi deepseek-v4-flash e deepseek-v4-flash-vision-exp sono ancora accettati, ma quei modelli sono ritirati, quindi le richieste vanno a DeepSeek-V4.1-Flash-1017 e vengono fatturate al prezzo di Flash;
• deepseek-v4-pro è un nome di modello separato e attuale.

Quindi il tuo vecchio codice può continuare a funzionare ed eseguire comunque un modello diverso da quello di quando l'hai scritto. Va bene se volevi l'ultima versione, ed è una trappola se hai confrontato risultati a distanza di settimane. La pagina di documentazione non ha una data di pubblicazione, quindi considera la mappatura valida alla data sopra e rileggila quando è importante. Cosa è cambiato nel modello stesso è trattato in DeepSeek-V4.1-Flash-1017 is out.

Cosa controllare prima di inserire un id nel codice#

1. Copia l'id dalla documentazione del provider che chiami effettivamente. Provider diversi nominano la stessa famiglia in modo diverso, quindi prendi l'id dalla documentazione di CheapTokens quando chiami CheapTokens, e da quella di DeepSeek quando chiami DeepSeek. Non mescolarli.
2. Decidi: alias o pinnato? Se la stringa non ha una data o un suffisso di build, presupponi che possa cambiare.
3. Controlla il base URL e lo stile dell'API. CheapTokens parla i formati OpenAI Chat Completions e Anthropic Messages su https://api.cheaptokens.dev/v1; l'API di DeepSeek usa https://api.deepseek.com (stile OpenAI) e https://api.deepseek.com/anthropic (stile Anthropic). Un id corretto sul base URL sbagliato è un errore.
4. Apri la tabella dei prezzi per esattamente quell'id e annota la data. I prezzi appartengono a un modello, non a una famiglia.
5. Tieni l'id in un unico posto (un file di configurazione o una variabile d'ambiente) invece che sparso nel codice.
6. Registra il modello che ha risposto. Le risposte in stile OpenAI contengono un campo model; salvalo accanto ai tuoi risultati.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)

# Take the exact id from the CheapTokens docs; this one is an example.
MODEL_ID = os.environ.get("MODEL_ID", "minimax-m2.7")

response = client.chat.completions.create(
    model=MODEL_ID,
    messages=[{"role": "user", "content": "Say hello in five words."}],
    max_tokens=50,
)

print("asked for:", MODEL_ID)
print("answered by:", response.model)
print(response.choices[0].message.content)

Le due righe stampate sono l'abitudine che vale la pena costruire: cosa hai chiesto e cosa ha risposto. Non codificare mai la chiave in modo fisso; vedi What is an API key and how to store it safely. Se è la tua prima chiamata, inizia da Your first API request with CheapTokens.

Confronta prezzi e risultati versione per versione#

La maggior parte della confusione nasce dal confrontare le cose sbagliate. Prima di confrontare due prezzi o due risposte, annota per entrambi i lati: l'id esatto, il provider e la data. Due id che dicono entrambi "Flash" ma hanno una generazione o un suffisso di build diverso sono modelli diversi con date di rilascio diverse. Lo stesso vale per i benchmark di un post di notizie: appartengono alla build indicata nel post e non sono una promessa su nessun altro id.

Vale anche al contrario. Quando testi un modello sui tuoi prompt, mantieni fisso l'insieme dei prompt e cambia una cosa alla volta: l'id o il prompt, non entrambi. Contare i token per il confronto? What is a token spiega come vengono misurati i numeri.

Id di esempio su cui esercitarsi#

CheapTokens mantiene un unico saldo per tutti i modelli, quindi puoi cambiare id con la stessa chiave:

• MiniMax-M2.7 (minimax-m2.7, id del gateway MiniMaxAI/MiniMax-M2.7): contesto da 180K, fino a 8.192 token di output, un unico prezzo a qualsiasi ora. Input $0.05 e output $0.15 per 1M di token, entrambi sotto il riferimento di OpenRouter.

La tabella seguente si ricalcola in tempo reale per un piccolo job di 100.000 token di input e 20.000 di output, con una colonna OpenRouter come riferimento:

Nota che ogni riga è un id specifico. Se sostituisci minimax-m2.7 con un altro id, cambi sia il modello che il prezzo.

Riepilogo rapido#

• La stringa model decide quale modello risponde e quanto costa.
• Un id senza suffisso di build è probabilmente un alias e può essere ripuntato; un id con una build è pinnato.
• I vecchi nomi possono continuare a funzionare eseguendo silenziosamente un modello più recente, come con deepseek-v4-flash nella documentazione di DeepSeek il 22 ottobre 2026.
• Flash e Pro sono tier all'interno di una famiglia, non dimensioni universali.
• Copia sempre l'id dalla documentazione del provider che chiami e registra quale modello ha risposto.

Pronto a provarlo? Ottieni una chiave, ricarica il saldo e invia lo snippet sopra con un id di modello dalla documentazione di CheapTokens.