---
title: "Modelle über die API abfragen"
description: "Die beiden Antwortformate von GET /v1/models, das Auslesen der Modell-IDs sowie der Unterschied zwischen Modellsichtbarkeit und tatsächlicher Aufrufbarkeit."
headingIds: {"OpenAI-Format":"section-1","Anthropic-Format":"section-2","Ergebnisse der Abfrage verwenden":"section-3","Liste leer oder Modelle fehlen":"section-4"}
---

<aside className="docs-publication" data-pagefind-ignore>

Dokumentation gepflegt von [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Quellen und Korrekturen](https://1zheai.com/en/editorial/).

Fehler gefunden? [Support kontaktieren](mailto:support@1zheai.com) mit Seitenadresse und Beschreibung. Senden Sie keine API-Schlüssel oder Kontodaten.

</aside>
Zuerst Modelle abfragen, dann Anfragen schreiben. `GET https://1zheai.com/v1/models` gibt die unter dem aktuellen Schlüssel, der Gruppe und den Modellbeschränkungen sichtbaren Modelle zurück, ohne dass eine Inferenzanfrage gesendet werden muss.

## OpenAI-Format

```bash
curl --fail-with-body --connect-timeout 10 --max-time 30 \
  https://1zheai.com/v1/models \
  -H "Authorization: Bearer $ONEZHE_API_KEY"
```

Nachfolgend eine vereinfachte Strukturübersicht; die Liste richtet sich nach der tatsächlichen Rückgabe:

```json
{
  "object": "list",
  "data": [{"id": "gpt-5.6-sol", "object": "model"}]
}
```

Wenn `jq` installiert ist, kann nach der Anfrage `| jq -r '.data[].id'` angehängt werden, wobei pro Zeile eine Modell-ID angezeigt wird. Verwechseln Sie nicht das `model_name` der öffentlichen Preis-API mit dem `id` hier.

## Anthropic-Format

Bei Verwendung der folgenden beiden Anfrage-Header liefert derselbe Pfad Daten im Anthropic-Stil:

```bash
curl --fail-with-body https://1zheai.com/v1/models \
  -H "x-api-key: $ONEZHE_API_KEY" \
  -H "anthropic-version: 2023-06-01"
```

Achten Sie auf `data[].id`, `data[].display_name` und `has_more`. Nach dem Wechsel der Authentifizierungsmethode nicht weiter nach der Antwortstruktur der anderen Methode parsen.

## Ergebnisse der Abfrage verwenden

1. Die vollständige ID aus `data[].id` kopieren und Groß-/Kleinschreibung, Bindestriche und Datums-Suffix beibehalten.
2. Den Schnittstellentyp dieses Modells im [Modellkatalog der Konsole](https://1zheai.com/model-catalog?lng=de) abgleichen.
3. Mit einer minimalen Textanfrage prüfen und schrittweise Bilder, Tools oder weitere Parameter hinzufügen.

Die Modellliste ist keine Echtzeit-Verfügbarkeitsprüfung und enthält nicht alle Parameterbeschränkungen. Ist ein Modell sichtbar, aber derzeit kein verfügbarer Upstream vorhanden, kann die Anfrage dennoch fehlschlagen; das HTTP-Verfügbarkeitsmonitoring auf der offiziellen Website bedeutet nicht, dass jedes Modell erfolgreich inferieren kann.

## Liste leer oder Modelle fehlen

Modellbeschränkung und Gruppe des Schlüssels prüfen; die auf der öffentlichen Preis-Seite angezeigten Modelle sind nicht unbedingt für jeden Schlüssel freigeschaltet. Bei 401 zuerst den Schlüsselstatus prüfen, bei 403 die Zugriffsbedingungen; ausführliche Schritte unter [Fehlercodes und Fehlersuche](/de/docs/troubleshooting/).

Modellreihen und Auswahlhinweise unter [Unterstützte Modelle](/de/docs/models/).