# Endpoint dei modelli e dei crediti: GET /models e GET /credits

> GET /api/v1/models elenca gli id dei modelli chiamabili con la tua chiave; GET /api/v1/credits mostra i crediti rimasti. Esempi e i 12 modelli open-weight.

- URL: https://llmwithcrypto.com/it/docs/models/
- Ultimo aggiornamento: 2026-10-23
- Editore: LLMwithCrypto (https://llmwithcrypto.com)

Due piccoli endpoint in sola lettura. Uno elenca i modelli che puoi mettere nel campo `model`; l'altro ti dice quanti crediti restano prima che la tua app rimanga a secco. Nessuno dei due costa nulla.

**Risposta rapida — Come elenco i modelli e controllo i miei crediti su LLMwithCrypto?**

Chiama `GET https://llmwithcrypto.com/api/v1/models` per la lista degli id dei modelli, nel formato OpenAI, e `GET https://llmwithcrypto.com/api/v1/credits` per i crediti rimasti in dollari USA. Entrambi prendono la tua chiave API come Bearer token e sono gratuiti. Al 23 ottobre 2026, **LLMwithCrypto** serve 12 modelli open-weight, da DeepSeek V4 Pro a Mistral Small 4.

## Elenca i modelli

`GET /api/v1/models`

Restituisce i modelli che la tua chiave può chiamare, nel formato lista di OpenAI. Il `id` è il valore da inviare nel campo `model` di una chat completion. L'esempio mostra le prime quattro voci; `created` è a scopo illustrativo.

Autenticazione: chiave API nell'header `Authorization: Bearer API_KEY`.

**Risposta** `200`

```json
{
  "object": "list",
  "data": [
    {
      "id": "deepseek-v4-pro",
      "object": "model",
      "created": 1792742400,
      "owned_by": "deepseek"
    },
    {
      "id": "deepseek-v4.1-flash",
      "object": "model",
      "created": 1792742400,
      "owned_by": "deepseek"
    },
    {
      "id": "deepseek-r1",
      "object": "model",
      "created": 1792742400,
      "owned_by": "deepseek"
    },
    {
      "id": "qwen3.5-397b-a17b",
      "object": "model",
      "created": 1792742400,
      "owned_by": "qwen"
    }
  ]
}
```

*curl*

```bash
curl -s "https://llmwithcrypto.com/api/v1/models" \
  -H "Authorization: Bearer $LLMWITHCRYPTO_API_KEY"
```

*Python*

```python
import os

from openai import OpenAI

client = OpenAI(
    base_url="https://llmwithcrypto.com/api/v1",
    api_key=os.environ["LLMWITHCRYPTO_API_KEY"],
)
for model in client.models.list():
    print(model.id, model.owned_by)
```

*Node.js*

```javascript
import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://llmwithcrypto.com/api/v1',
  apiKey: process.env.LLMWITHCRYPTO_API_KEY,
});
for await (const model of client.models.list()) console.log(model.id, model.owned_by);
```

## Leggi i crediti rimasti

`GET /api/v1/credits`

Restituisce i crediti sul tuo account in dollari USA, come stringa decimale così che non si perda precisione, e l'ora dell'ultimo aggiornamento. Chiamarlo non costa nulla. Le cifre sono a scopo illustrativo.

Autenticazione: chiave API nell'header `Authorization: Bearer API_KEY`.

**Risposta** `200`

```json
{
  "object": "credits",
  "balance_usd": "41.2731",
  "currency": "USD",
  "updated_at": "2026-10-23T09:41:07Z"
}
```

*curl*

```bash
curl -s "https://llmwithcrypto.com/api/v1/credits" \
  -H "Authorization: Bearer $LLMWITHCRYPTO_API_KEY"
```

*Python*

```python
import os

import requests

resp = requests.get(
    "https://llmwithcrypto.com/api/v1/credits",
    headers={"Authorization": "Bearer " + os.environ["LLMWITHCRYPTO_API_KEY"]},
    timeout=30,
)
resp.raise_for_status()
print("credit left:", resp.json()["balance_usd"], "USD")
```

*Node.js*

```javascript
const res = await fetch('https://llmwithcrypto.com/api/v1/credits', {
  headers: { Authorization: `Bearer ${process.env.LLMWITHCRYPTO_API_KEY}` },
});
const credits = await res.json();
console.log('credit left:', credits.balance_usd, 'USD');
```

## Quali id dei modelli posso usare?

Il valore `model`, a cosa serve il modello e la sua context window, al 23 ottobre 2026. I prezzi per milione di token sono nella [pagina dei prezzi](https://llmwithcrypto.com/it/pricing/).

| Id del modello | Modello | Contesto | Input / 1M | Output / 1M |
| --- | --- | --- | --- | --- |
| `deepseek-v4-pro` | [DeepSeek V4 Pro](https://llmwithcrypto.com/it/models/deepseek-v4-pro/) | 1M | $1.254 | $3.762 |
| `deepseek-v4.1-flash` | [DeepSeek V4.1 Flash](https://llmwithcrypto.com/it/models/deepseek-v4-1-flash/) | 1M | $0.285 | $1.14 |
| `deepseek-r1` | [DeepSeek R1](https://llmwithcrypto.com/it/models/deepseek-r1/) | 160K | $0.57 | $2.208 |
| `qwen3.5-397b-a17b` | [Qwen3.5 397B A17B](https://llmwithcrypto.com/it/models/qwen3-5-397b-a17b/) | 256K | $0.57 | $3.42 |
| `qwen3-235b-a22b-instruct-2507` | [Qwen3 235B A22B Instruct](https://llmwithcrypto.com/it/models/qwen3-235b-a22b-instruct-2507/) | 256K | $0.161 | $0.57 |
| `gpt-oss-120b` | [gpt-oss-120b](https://llmwithcrypto.com/it/models/gpt-oss-120b/) | 128K | $0.142 | $0.57 |
| `gpt-oss-20b` | [gpt-oss-20b](https://llmwithcrypto.com/it/models/gpt-oss-20b/) | 128K | $0.033 | $0.161 |
| `glm-4.7` | [GLM-4.7](https://llmwithcrypto.com/it/models/glm-4-7/) | 200K | $0.57 | $2.09 |
| `llama-3.3-70b-instruct` | [Llama 3.3 70B Instruct](https://llmwithcrypto.com/it/models/llama-3-3-70b-instruct/) | 128K | $0.209 | $0.475 |
| `gemma-4-31b` | [Gemma 4 31B](https://llmwithcrypto.com/it/models/gemma-4-31b/) | 256K | $0.19 | $0.38 |
| `mistral-large-3` | [Mistral Large 3](https://llmwithcrypto.com/it/models/mistral-large-3/) | 256K | $0.475 | $1.424 |
| `mistral-small-4` | [Mistral Small 4](https://llmwithcrypto.com/it/models/mistral-small-4/) | 256K | $0.142 | $0.57 |

## La mia app dovrebbe leggere la lista dei modelli all'avvio?

È una buona abitudine. I modelli vengono aggiunti e, più raramente, ritirati; ogni modifica è datata nel [changelog](https://llmwithcrypto.com/it/changelog/). Leggere `GET https://llmwithcrypto.com/api/v1/models` all'avvio della tua app le permette di verificare che l'id con cui è configurata esista ancora, invece di scoprirlo da un `404 model_not_found` in produzione.

La lista contiene solo modelli open-weight. Solo modelli open-weight le cui licenze ne consentono l'erogazione come API: DeepSeek, Qwen, gpt-oss, Mistral, Llama, Gemma e altri elencati nella pagina dei modelli. Li eseguiamo su GPU che noleggiamo e gestiamo. Ogni modello mantiene la propria licenza e policy d'uso (per esempio la Llama Acceptable Use Policy di Meta e l'avviso "Built with Llama"); usare un modello tramite noi significa accettarle.

## Come faccio a non restare senza crediti?

- **Controlla i crediti regolarmente.** `GET https://llmwithcrypto.com/api/v1/credits` è gratis; un controllo ogni ora o dopo ogni batch basta per la maggior parte delle app.
- **Imposta una tua soglia.** Quando `balance_usd` scende sotto un livello che scegli tu, avvisati e ricarica prima che le chiamate inizino a fallire.
- **Gestisci `402`.** Una chiamata che i crediti non possono pagare torna come `402 insufficient_balance` e non costa nulla; la [pagina degli errori](https://llmwithcrypto.com/it/docs/errors/) mostra come reagire.

I crediti non hanno data di scadenza: quello che non spendi questo mese è ancora lì l'anno prossimo, quindi ricaricare in anticipo non ti costa nulla.

## Modelli e crediti: domande frequenti

### Perché GPT o Claude non sono nella lista?

Non vendiamo l'accesso a GPT, Claude, Gemini o Grok: i loro produttori vietano la rivendita dell'accesso alle API senza la loro approvazione, e noi non l'abbiamo.

### La lista dei modelli mostra i prezzi?

No, segue il formato OpenAI. I prezzi per milione di token sono nella [pagina dei prezzi](https://llmwithcrypto.com/it/pricing/) e su ogni pagina del modello.

### I crediti sono condivisi tra le mie chiavi API?

Sì. Le chiavi appartengono all'account e spendono tutte gli stessi crediti. Crea una chiave API per ogni app, agente o membro del team e revoca quella che vuoi dalla dashboard senza toccare le altre.

---

LLMwithCrypto: LLMwithCrypto è un'API LLM compatibile con OpenAI per modelli open-weight — DeepSeek V4 Pro, DeepSeek V4.1 Flash, DeepSeek R1, Qwen3.5 397B A17B, Qwen3 235B A22B Instruct, gpt-oss-120b, gpt-oss-20b, GLM-4.7, Llama 3.3 70B Instruct, Gemma 4 31B, Mistral Large 3, Mistral Small 4 — pagati a token da un saldo prepagato in criptovalute, al 5% sotto il prezzo mediano degli host pubblici. Senza KYC: niente documento, niente selfie, niente documenti. I prompt e gli output non vengono memorizzati.