GloopAPI-Integrationsleitfaden
Modellauswahl
Für den aktuellen Schlüssel verfügbare Modelle entdecken.
Modell-IDs müssen aus dem für Ihre Key verfügbaren Katalog stammen. Die anonyme Modellübersicht dient dem Durchsuchen, nicht als Ausführungsberechtigung oder Garantie für Schnittstellenfunktionen, Preise oder Produktionsfreigabe.
Text und Protokolle
Lesen Sie zuerst den Modellkatalog Ihres Schlüssels. Listen und Details verwenden das OpenAI-Format. Chatmodelle werden über Chat Completions oder Responses aufgerufen; prüfen Sie vorher die benötigten Fähigkeiten.
Bildeingaben erfordern ein Modell mit Bildverständnis. Strukturierte Ausgaben und Werkzeugaufrufe hängen vom gewählten Modell ab; eine gelistete ID garantiert nicht jedes optionale Feld.
Bild- und Videofunktionen
Persistente Abläufe müssen den speziellen Funktionskatalog lesen und Schalter, Eingabemodi, Größen und vollständige Voreinstellungen vor dem Kostenvoranschlag prüfen. Die aktuelle Basis persistenter Bilder umfasst Ark Seedream Pro/Lite und Qwen. Synchrone Venice-Text-zu-Bild-Generierung liefert nur ein Bild ohne Referenzbildunterstützung; synchrone Fähigkeiten sind keine Zusage für den persistenten Katalog.
Der Videokatalog liefert vollständige ausführbare preset. Verwenden Sie diese als Einheit, ohne Auflösung, Dauer, Audio und Seitenverhältnis verschiedener Modi neu zu kombinieren. Frame-Eingaben müssen vom Modell zugelassene gehostete Dateien sein. Wenn öffentlich signierte HTTPS-Eingaben nicht bereit sind, können entsprechende Bildmodi fehlen.
Versionen und Ausführungsdatensätze
Aliase dienen als öffentliche Modellidentität und erben Dienst-Modellberechtigungen nicht automatisch. Neue Aufgaben verwenden die dann gültigen Routen und Preise; angenommene Aufgaben bewahren Ausführungs- und Abrechnungsnachweise. Ändern sich Katalog oder Preise nach dem Kostenvoranschlag, bestätigen Sie erneut. Stellen Sie vorhandene Aufgaben mit ursprünglichem Anfrageschlüssel und ursprünglicher Identität wieder her.
Prüfen Sie bei leerem Funktionskatalog zuerst Berechtigungen und Schalter; testen Sie die Verfügbarkeit nicht durch wiederholte Generierungsaufrufe. Fehler- und Abrechnungsgrenzen stehen unter Fehlerbehandlung und Abrechnung.