Elenca i modelli con GET /v1/models per trovare l'id esatto del modello

Il tuo codice restituisce un 404 su un nome di modello che sembrava corretto nell'esempio di qualcun altro. Chiedilo direttamente all'API: una singola richiesta GET a https://api.cheaptokens.dev/v1/models elenca i modelli che puoi chiamare, con i relativi limiti di contesto e di output. Copia l'id da quella risposta, non a memoria, e controlla il limite prima di impostare max_tokens.

La pagina della documentazione (CheapTokens docs, verificata il 28 ottobre 2026) descrive GET /v1/models come l'elenco dei modelli richiamabili con i limiti di contesto e di output. Accanto ci sono GET /v1/models/{model} per un singolo modello e GET /v1/capabilities. La chat stessa passa attraverso POST /v1/chat/completions (compatibile con OpenAI) o POST /v1/messages (compatibile con Anthropic).

Perché lo stesso modello ha un id diverso ovunque#

Supponiamo che tu abbia trovato un tutorial per un altro provider. Usa model: "deepseek-chat", lo incolli accanto alla base URL di CheapTokens e la richiesta fallisce. Non c'è nulla di sbagliato nella tua chiave. I provider nominano lo stesso modello in modo diverso: un prefisso come deepseek-ai/, un suffisso di versione come -0731, maiuscole e minuscole diverse. L'API accetta solo la stringa esatta che elenca, e nemmeno un nome abbreviato preso da un'etichetta di prezzo funzionerà.

È proprio questo il motivo per cercare l'id una volta sola. Se vuoi la storia completa di come appare un id sbagliato sullo schermo, API 401 or 404 error: wrong key, base URL or model id lo illustra passo per passo. Questa guida è il passo precedente: trovare l'id giusto per non vedere mai quell'errore.

Chiedi all'API: una richiesta#

Scegli la scheda che usi. Entrambe inviano la stessa richiesta. In entrambi gli esempi la chiave proviene dalla variabile d'ambiente CHEAPTOKENS_API_KEY (la chiave è nella dashboard una volta che ci sono fondi sul saldo).

export CHEAPTOKENS_API_KEY="sk-your-key"

curl https://api.cheaptokens.dev/v1/models \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY"

import json
import os

import requests

resp = requests.get(
    "https://api.cheaptokens.dev/v1/models",
    headers={"Authorization": f"Bearer {os.environ['CHEAPTOKENS_API_KEY']}"},
    timeout=30,
)
resp.raise_for_status()
print(json.dumps(resp.json(), indent=2))

La versione Python stampa il JSON grezzo di proposito. Leggilo una volta con i tuoi occhi: stai cercando gli id dei modelli e, accanto, i limiti di contesto e di output. Copia ogni id dal printout per intero.

I tre id e i loro limiti#

La documentazione elenca questi modelli richiamabili (verificata il 28 ottobre 2026). Invia la stringa in formato codice all'inizio di ogni riga come model:

• zai-org/GLM-5.3-Flash — contesto 390K, fino a 8.192 token di output.
• deepseek-ai/DeepSeek-V4-Flash-0731 — contesto 380K, fino a 32.768 token di output.
• MiniMaxAI/MiniMax-M2.7 — contesto 180K, fino a 8.192 token di output.

Due numeri contano per la maggior parte delle decisioni. Il contesto è quanto il modello può contenere in una singola richiesta, il tuo prompt e la sua risposta insieme. Il limite di output è la risposta singola più lunga. Se queste parole sono nuove, how to read AI model names e why an answer stops mid-sentence le spiegano in linguaggio semplice.

Scegli un primo modello per il tuo compito#

Non ti serve uno studio approfondito di benchmark per iniziare. Due domande risolvono la maggior parte delle prime scelte: quanto è grande il tuo input e quanto deve essere lunga la risposta? Clicca il caso più vicino al tuo.

Tutti e tre condividono un unico saldo e un unico prezzo a qualsiasi ora del giorno, senza fasce di punta, quindi cambiare in seguito costa solo una stringa modificata. Rispetto a OpenRouter, ciascuno dei tre è più economico in totale, con input e output conteggiati insieme. Ecco come appare un carico di lavoro: supponiamo che tu gestisca un piccolo assistente che invia 2.000 token di input e ne riceve 500 indietro, 1.000 volte al giorno. La tabella live qui sotto calcola esattamente questo.

I prezzi correnti per token di ogni modello sono nella pricing page, e le model pages approfondiscono ciascuno. Se vuoi un confronto affiancato per compito, c'è GLM vs DeepSeek vs MiniMax: which model to choose.

Imposta max_tokens dal limite, poi invia la richiesta#

Un errore comune: chiedi un report lungo a un modello il cui limite è 8.192, e la risposta si interrompe a metà. Il limite che hai visto nell'elenco è il tetto per max_tokens. Resta pari o sotto.

Ecco una richiesta con l'id completo dall'elenco. Chiede una risposta lunga al modello che lo consente:

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Write a 1,500-word guide to API keys."}],
    "max_tokens": 4000
  }'

È la tua prima chiamata? Your first API request with CheapTokens illustra il formato della risposta e il campo usage.

Per fissare la routine, metti i passaggi in ordine:

Se la richiesta fallisce ancora#

Parti dalla stringa. Un id di modello che differisce di un carattere è la causa abituale di un 404, quindi incollalo di nuovo dall'elenco invece di ridigitarlo. Un 402 significa che il saldo è esaurito, e il rate limit è di 120 richieste al minuto per chiave API. Gli errori tornano nella forma JSON standard di OpenAI/Anthropic, quindi gli SDK li analizzano come al solito. Per la procedura completa, vedi API 401 or 404 error.

L'API è compatibile con OpenAI e Anthropic su https://api.cheaptokens.dev/v1; gli SDK Anthropic e Claude Code usano la root URL https://api.cheaptokens.dev senza /v1. Altri dettagli di configurazione sono nella docs.