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

# Devin Desktop-Modelle und Preise auflisten

> Listen Sie die für Ihr Konto verfügbaren Devin Desktop-Modelle samt Modell-UIDs, Namen und den Preisen pro Token oder pro Nachricht auf, die Ihrem Team berechnet werden.

<div id="overview">
  ## Übersicht
</div>

Gibt die Modelle zurück, die dem aufrufenden Account zur Verfügung stehen, samt den Preisen, die diesem Account tatsächlich berechnet werden. Nutzen Sie diesen Endpunkt als programmatische Source of Truth für Modellpreise, anstatt Preise von der [Modelle-Seite](/de/desktop/models) zu übernehmen.

Die Preise hängen vom Plan und Abrechnungsmodell des Aufrufers ab, daher können zwei Teams für dasselbe Modell unterschiedliche Werte erhalten.

<Note>Dieser Endpunkt befindet sich im Alpha-Stadium (`v2alpha`). Die Struktur der Antwort kann sich ändern.</Note>

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

Übergeben Sie einen API-Schlüssel im `Authorization`-Header:

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

Verwenden Sie einen Devin-[Service-Benutzer-API-Schlüssel](/de/api-reference/authentication) (`cog_...`). Die Rolle des Service-Benutzers muss die Berechtigung **Use Devin Desktop** umfassen, und der Zugriff auf Devin Desktop muss für das Konto aktiviert sein.

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

<ParamField query="filter" type="string">
  Ohne Angabe werden alle Modelle aufgelistet, die Ihr Plan und Ihr Abrechnungsmodell zulassen – teamweite Beschränkungen bleiben dabei unberücksichtigt.

  Setzen Sie den Wert auf `allowlist`, um zusätzlich die Allowlist Ihres Teams, die Vorgaben der Organisation sowie Gruppenbeschränkungen anzuwenden. Die Liste entspricht dann dem, was Nutzer in der Modellauswahl von Devin Desktop sehen.
</ParamField>

<div id="example-request">
  ### Beispielanfrage
</div>

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

Nur die Modelle, die Ihre Nutzer auswählen können:

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

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

<ResponseField name="models" type="object[]">
  Für den Aufrufer verfügbare Modelle. Deaktivierte Modelle sind nicht enthalten.

  <Expandable title="Eigenschaften">
    <ResponseField name="uid" type="string">
      Stabile Modellkennung, z. B. `claude-sonnet-4-5`.
    </ResponseField>

    <ResponseField name="name" type="string">
      Anzeigename, der in der Modellauswahl erscheint.
    </ResponseField>

    <ResponseField name="pricing_dimensions" type="object[]">
      Preise, die dem Aufrufer für dieses Modell berechnet werden. Bei kostenlosen Modellen leer.

      <Expandable title="Eigenschaften">
        <ResponseField name="label" type="string">
          Wofür der Preis gilt, in snake\_case: `input`, `output`, `cached_input`, `cache_read` oder `cache_write` für Token-Preise; bei Preisen in einer Nicht-Währungseinheit die abgerechnete Menge, z. B. `message` für die Abrechnung pro Nachricht. Fusion-Modelle führen zusätzlich die Preise ihres Sidekicks mit dem Präfix `sidekick_` auf, z. B. `sidekick_input` oder `sidekick_message`.
        </ResponseField>

        <ResponseField name="unit" type="string">
          Die Einheit, in der `value` angegeben ist, in snake\_case, z. B. `usd`, `acus` oder `credits`.
        </ResponseField>

        <ResponseField name="value" type="number">
          Der Preis in `unit`, pro `denominator`.
        </ResponseField>

        <ResponseField name="denominator" type="string">
          Die Menge, für die der Preis gilt, z. B. `1M tokens` oder `message`.
        </ResponseField>

        <ResponseField name="info" type="string">
          Optionaler Hinweis zum Preis, z. B. `Higher effort consumes more tokens`.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<div id="example-response">
  ### Beispielantwort
</div>

Die folgenden Modelle und Preise dienen nur zur Veranschaulichung des Antwortformats. Rufen Sie den Endpunkt auf, um Ihre tatsächlichen Preise zu erhalten.

```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">
  ## Fehlerantworten
</div>

Fehler werden als `{"error": "<message>"}` zurückgegeben.

| Status | Ursache                                                                                                            |
| ------ | ------------------------------------------------------------------------------------------------------------------ |
| `400`  | `filter` ist auf einen anderen Wert als `allowlist` gesetzt                                                        |
| `401`  | Fehlender oder ungültiger API-Schlüssel                                                                            |
| `403`  | Der Nutzer des Schlüssels hat keinen Zugriff auf Devin Desktop                                                     |
| `429`  | Ratenlimit überschritten; warten Sie die im `Retry-After`-Header angegebene Zeit ab, bevor Sie es erneut versuchen |
