Modelle über die API abfragen

Die beiden Antwortformate von GET /v1/models, das Auslesen der Modell-IDs sowie der Unterschied zwischen Modellsichtbarkeit und tatsächlicher Aufrufbarkeit.

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

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

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

1
{
2
  "object": "list",
3
  "data": [{"id": "gpt-5.6-sol", "object": "model"}]
4
}

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:

1
curl --fail-with-body https://1zheai.com/v1/models \
2
  -H "x-api-key: $ONEZHE_API_KEY" \
3
  -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

Die vollständige ID aus data[].id kopieren und Groß-/Kleinschreibung, Bindestriche und Datums-Suffix beibehalten.
Den Schnittstellentyp dieses Modells im Modellkatalog der Konsole abgleichen.
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.

Modellreihen und Auswahlhinweise unter Unterstützte Modelle.