Modellliste abrufen

Ruft alle aktuell auf der Plattform verfügbaren Modelle ab, zweistufig gruppiert nach Modellfähigkeit und Modellanbieter. Mit der erhaltenen modelId können Sie das Modell in anderen Schnittstellen referenzieren, die die Angabe eines Modells erfordern.

Diese Schnittstelle ist auf Kontoebene auf 60 Anfragen/Minute begrenzt. Die Modellliste der Plattform ändert sich selten; es wird empfohlen, das Ergebnis aufruferseitig zu cachen.

Anfragemethode

GET

Anfrage-URL

https://api-${endpoint}.gptbots.ai/v1/model/list

Authentifizierung der Anfrage

Diese Schnittstelle verwendet DevKey / DevSecret auf Kontoebene, übertragen per HTTP-Basic-Authentifizierung:

                      
                      Authorization: Basic base64(${DevKey}:${DevSecret})

                    

Verketten Sie DevKey und DevSecret mit einem Doppelpunkt, kodieren Sie die gesamte Zeichenkette mit Base64 und stellen Sie Basic voran (beachten Sie das Leerzeichen).

So erhalten Sie DevKey / DevSecret: Melden Sie sich in der Konsole an und öffnen Sie Persönliches Zentrum - Konto - Entwicklerinformationen; dort finden Sie die Entwicklerkennung (DevKey) und das API DevSecret.

⚠️ Nicht mit der Authentifizierung auf Agent-Ebene verwechseln: Schnittstellen wie die Konversations-APIs verwenden den API Key des Agents (Authorization: Bearer ${API Key}); diese Schnittstelle verwendet DevKey / DevSecret des Kontos mit Basic-Authentifizierung. Beide sind nicht austauschbar.

Base64 ist eine umkehrbare Kodierung, keine Verschlüsselung. Behandeln Sie die kodierte Zeichenkette wie ein Klartext-Passwort — nicht in Code-Repositories einchecken oder in öffentliche Dokumente schreiben.

Anfrage

Beispielanfrage

                      
                      curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/model/list' \
-H 'Authorization: Basic ${base64(DevKey:DevSecret)}'

                    

Anfrage-Header

Anfrageparameter

Keine.

Antwort

Beispielantwort

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "CHAT": {
      "OPEN_AI": [
        { "aiModelVersion": "gpt-4o", "modelId": "65f2c1a8d3b4e5f601234567" },
        { "aiModelVersion": "gpt-3.5-turbo", "modelId": "65f2c1a8d3b4e5f601234568" }
      ],
      "ANTHROPIC_CLAUDE": [
        { "aiModelVersion": "claude-opus-4-8", "modelId": "65f2c1a8d3b4e5f601234569" }
      ]
    },
    "EMBEDDING": {
      "OPEN_AI_EMB": [
        { "aiModelVersion": "text-embedding-3-large", "modelId": "65f2c1a8d3b4e5f60123456a" }
      ]
    },
    "RERANK": { },
    "SPEECH2TEXT": { },
    "TEXT2SPEECH": { },
    "MODERATION": { },
    "ANONYMIZATION": { }
  }
}

                    

Erfolgsantwort

Zweistufige Struktur von data

                      
                      data
 └── Modellfähigkeit      äußerer Key, 7 Arten, feste Reihenfolge
      └── Modellanbieter   innerer Key, z. B. OPEN_AI
           └── [ Modellliste ]

                    

Die äußeren Keys sind Modellfähigkeiten, festgelegt auf die folgenden 7 Arten und stets in dieser Reihenfolge zurückgegeben:

Die inneren Keys sind Anbieterkennungen. Am Beispiel von CHAT können u. a. folgende Werte auftreten: OPEN_AI, AZURE, ANTHROPIC_CLAUDE, GEMINI, ALI_QWEN, DEEP_SEEK, KIMI, META_LLAMA, MISTRAL, ZHIPU_CHATGLM, HUNYUAN, ERINE, XAI_GROK, BYTEDANCE_SEED, SENSE. Unter anderen Fähigkeiten sind die Anbieterkennungen anders (z. B. OPEN_AI_EMB, JINA_EMB unter EMBEDDING).

• Wenn für eine Fähigkeit derzeit keine Modelle verfügbar sind, ist ihr Wert ein leeres Objekt {}. Der Key erscheint dennoch und wird nie weggelassen; prüfen Sie vor dem Iterieren auf Leerheit.
• Die Plattform kann Anbieter hinzufügen oder entfernen. Verlassen Sie sich auf die tatsächliche API-Antwort und kodieren Sie die Anbieterliste nicht fest in Ihren Code.
• Anbieter und Modelle werden nach der auf der Plattform konfigurierten Anzeigepriorität sortiert. Die Reihenfolge dient nur der Anzeige — bauen Sie keine Geschäftslogik darauf auf (z. B. „das erste ist das Standardmodell").

Fehlerantwort

Fehlercodes