Dokumentation

API-Referenz

Bilder synchron generieren

POST/v1/images/generations

Synchrone Anfragen prüfen Parameter je nach Modell; nur die vom gewählten Modell unterstützten Bildfunktionen sind verfügbar. Qwen: maximal 6 Bilder/3 Referenzbilder; Ark: modellabhängige Grenzen; Venice erzeugt ein Bild aus Text und unterstützt keine Referenzbilder. Gewöhnliche API-Dateien folgen der Aufbewahrungsfrist in Tagen und sind nicht mit persistenten Bildaufgaben gleichzusetzen.

Grenzen synchroner Ausgaben

Qwen unterstützt bis zu 6 Ausgabebilder und 3 Referenzbilder. Ark-Grenzen variieren je nach Modell; Venice bietet nur ein einzelnes Text-zu-Bild-Ergebnis. Wählen Sie zuerst das Modell und senden Sie dann die zugehörigen Felder. Senden Sie keine Referenzbildanfragen an Modelle ohne diese Unterstützung.

Für Kostenbestätigung, langfristigen Verlauf und Wiederherstellung nach Verbindungsabbruch verwenden Sie persistente Bildabläufe, statt synchrone Generierung automatisch zu wiederholen. Dateiarchivierungsheader in synchronen Antworten beschreiben nur die Speicherphase. Normale Dateiaufbewahrung unterscheidet sich vom Referenzschutz durch Aufgaben; siehe Abrechnung.

Authentifizierung und Berechtigungen

Verwenden Sie Ihren aktuellen GloopAPI-Schlüssel. Verfügbare Modelle, Funktionen und Berechtigungen hängen von seinem Katalog und der Endpunktdokumentation ab.

Authorization: Bearer $GLOOP_API_KEY

Authentifizierungsschemata: BearerAuth

Anfrage

Anfragekörper · application/json

Typ
object
Pflichtfelder
modelprompt

Anfragekörper erforderlich

  • image_urlsarrayOptional

    Modellabhängige Liste von Referenzbild-URLs. Qwen/Ark haben eigene Grenzen; Venice für synchrone Text-zu-Bild-Generierung lehnt dieses Feld ab.

    Unterfelder von image_urls (1)
    • []stringOptional
  • modelstringErforderlich

    Öffentliche Modell-ID aus dem Katalog des aktuellen Schlüssels.

  • promptstringErforderlich

    Generierungsprompt.

  • nintegerOptional

    Angeforderte Anzahl der Ausgabebilder, weiterhin durch das Modellmaximum begrenzt.

  • sizestringOptional

    Größenwert aus dem ausgewählten image-models-Eintrag; Funktionen und Größen werden je Modell geprüft.

  • response_formatstringOptional

    Modellabhängiges Ausgabeformat; nicht annehmen, dass jedes Modell alle Formate unterstützt.

  • userunknownOptional

    JSON-Wert gemäß Schema oder Protokoll des gewählten Tools; keine festen Felder annehmen.

  • extra_bodyunknownOptional

    JSON-Wert gemäß Schema oder Protokoll des gewählten Tools; keine festen Felder annehmen.

Antworten und Fehler

HTTP 200

Bilder erfolgreich synchron generiert

application/json

Typ
object
Pflichtfelder
createddata
  • createdintegerErforderlich

    Erzeugungszeit der Bildantwort in Unix-Sekunden.

  • dataarrayErforderlich

    Datenarray der aktuellen Seite/des Katalogs.

    Unterfelder von data (1)
    • []objectOptional
      Unterfelder von [] (7)
      • file_idstringOptional

        Öffentliche ID einer verwalteten Datei desselben Kontos und Schlüssels.

      • storage_statusstringOptional

        Dateiarchivierungsstatus; verwaltete Downloads sind erst nach ready garantiert verfügbar.

      • storage_errorstringOptional

        Öffentliche Kategorie eines Dateiarchivierungsfehlers.

      • expires_atintegerOptional

        Ablauf in Unix-Sekunden; 0 bedeutet keine feste Frist.

      • urlstringOptional

        Zugriffs-URL für Ergebnis oder Referenz; signierte URLs gelten nur kurzzeitig.

      • b64_jsonstringOptional

        Base64-Zeichenfolge des Bildes; nicht als URL aufrufen.

      • revised_promptstringOptional

        Vom Dienst zurückgegebener überarbeiteter Prompt, sofern vorhanden.

HTTP 400

Ungültige Anfragefelder oder Parameter.

application/json

Typ
object
Pflichtfelder
error

HTTP 401

Key fehlt, ist ungültig, abgelaufen oder widerrufen.

application/json

Typ
object
Pflichtfelder
error

HTTP 403

Unzureichende IP-, Konto-, Modell- oder Tool-Berechtigungen.

application/json

Typ
object
Pflichtfelder
error

HTTP 404

Objekt/Funktion nicht verfügbar oder Funktionsschalter deaktiviert.

application/json

Typ
object
Pflichtfelder
error

HTTP 409

Idempotenz-/Kostenvoranschlagskonflikt, Objekt nicht bereit oder noch referenziert.

application/json

Typ
object
Pflichtfelder
error

HTTP 429

Anfrage-/Warteschlangenlimit.

application/json

Typ
object
Pflichtfelder
error

HTTP 500

Interner Authentifizierungs- oder Datenspeicherungsfehler.

application/json

Typ
object
Pflichtfelder
error

HTTP 503

Dienst, Preisberechnung oder Speicherung nicht verfügbar.

application/json

Typ
object
Pflichtfelder
error
Bereit zum Entwickeln? Öffnen Sie Konsole um einen API-Schlüssel zu erstellen, oder durchsuchen Sie Funktionen.