> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Elencare i modelli e i prezzi di Devin Desktop

> Elenca i modelli di Devin Desktop disponibili per il tuo account, con i relativi UID, i nomi e i prezzi per token o per messaggio addebitati al tuo team.

<div id="overview">
  ## Panoramica
</div>

Restituisce i modelli disponibili per l'account chiamante, con i prezzi effettivamente addebitati a tale account. Usalo come fonte di verità programmatica per il pricing dei modelli, anziché copiare i prezzi dalla [pagina dei modelli](/it/desktop/models).

I prezzi dipendono dal piano e dal modello di billing del chiamante, quindi due team possono ottenere valori diversi per lo stesso modello.

<Note>Questo endpoint è in alpha (`v2alpha`). La struttura della risposta potrebbe cambiare.</Note>

<div id="authentication">
  ## Authentication
</div>

Passa una API key nell'header `Authorization`:

```
Authorization: Bearer <api-key>
```

Usa una [API key dell'utente di servizio](/it/api-reference/authentication) di Devin (`cog_...`). Il ruolo dell'utente di servizio deve includere l'autorizzazione **Use Devin Desktop** e l'accesso a Devin Desktop deve essere abilitato per l'account.

<div id="request">
  ## Richiesta
</div>

<ParamField query="filter" type="string">
  Lascia il campo vuoto per elencare tutti i modelli consentiti dal tuo piano e dal tuo modello di billing, ignorando le restrizioni a livello di team.

  Imposta `allowlist` per applicare anche la allowlist dei modelli del tuo team, i controlli dell'organizzazione e le group restriction, in modo che l'elenco corrisponda a quello che gli utenti vedono nel selettore di modelli di Devin Desktop.
</ParamField>

<div id="example-request">
  ### Esempio di richiesta
</div>

```bash theme={null}
curl https://server.codeium.com/api/v2alpha/models \
  -H "Authorization: Bearer $DEVIN_API_KEY"
```

Solo i modelli che i tuoi utenti possono selezionare:

```bash theme={null}
curl "https://server.codeium.com/api/v2alpha/models?filter=allowlist" \
  -H "Authorization: Bearer $DEVIN_API_KEY"
```

<div id="response">
  ## Risposta
</div>

<ResponseField name="models" type="object[]">
  Modelli disponibili per il chiamante. I modelli disabilitati non sono inclusi.

  <Expandable title="proprietà">
    <ResponseField name="uid" type="string">
      Identificatore stabile del modello, ad es. `claude-sonnet-4-5`.
    </ResponseField>

    <ResponseField name="name" type="string">
      Nome visualizzato nel selettore di modelli.
    </ResponseField>

    <ResponseField name="pricing_dimensions" type="object[]">
      Prezzi addebitati al chiamante per questo modello. Vuoto per i modelli senza addebito.

      <Expandable title="proprietà">
        <ResponseField name="label" type="string">
          Ciò per cui viene applicato il prezzo, in snake\_case: `input`, `output`, `cached_input`, `cache_read` o `cache_write` per il prezzo dei token; per prezzi espressi in un'unità non monetaria, la quantità a cui si applica il prezzo, ad es. `message` per il prezzo per messaggio. I modelli Fusion elencano anche i prezzi del rispettivo sidekick con il prefix `sidekick_`, ad es. `sidekick_input` o `sidekick_message`.
        </ResponseField>

        <ResponseField name="unit" type="string">
          L'unità in cui è espresso `value`, in snake\_case, ad es. `usd`, `acus` o `credits`.
        </ResponseField>

        <ResponseField name="value" type="number">
          Il prezzo in `unit`, per `denominator`.
        </ResponseField>

        <ResponseField name="denominator" type="string">
          La quantità a cui si applica il prezzo, ad es. `1M tokens` o `message`.
        </ResponseField>

        <ResponseField name="info" type="string">
          Nota facoltativa sul prezzo, ad es. `Higher effort consumes more tokens`.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<div id="example-response">
  ### Esempio di risposta
</div>

I modelli e i prezzi riportati di seguito servono solo a illustrare la struttura della risposta. Chiama l'endpoint per conoscere i prezzi effettivi.

```json theme={null}
{
  "models": [
    {
      "uid": "claude-sonnet-4-5",
      "name": "Claude Sonnet 4.5",
      "pricing_dimensions": [
        { "label": "input", "unit": "usd", "value": 3, "denominator": "1M tokens" },
        { "label": "cached_input", "unit": "usd", "value": 0.3, "denominator": "1M tokens" },
        { "label": "output", "unit": "usd", "value": 15, "denominator": "1M tokens" }
      ]
    },
    {
      "uid": "example-model",
      "name": "Example Model",
      "pricing_dimensions": [
        { "label": "message", "unit": "acus", "value": 0.5, "denominator": "message" }
      ]
    }
  ]
}
```

<div id="error-responses">
  ## Risposte di errore
</div>

Gli errori vengono restituiti nel formato `{"error": "<message>"}`.

| Status | Causa                                                                                                |
| ------ | ---------------------------------------------------------------------------------------------------- |
| `400`  | `filter` è impostato su un valore diverso da `allowlist`                                             |
| `401`  | API key mancante o non valida                                                                        |
| `403`  | L'utente associato alla key non dispone dell'accesso a Devin Desktop                                 |
| `429`  | Limite di frequenza superato; attendi il tempo indicato dall'header `Retry-After` prima di riprovare |