Dokumentation

API-Referenz

Kostenvoranschlag für persistente Bilder abrufen

POST/v1/image-quotes

Prüft nur Eingaben und Berechtigungen und sperrt keine Bilder. Kostenvoranschläge gelten 60 Sekunden; beim Erstellen werden Route/Preis/Anfrage erneut geprüft. Bei deaktiviertem Dienst wird 503 zurückgegeben.

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
modelpromptsize
Zusätzliche Eigenschaften
false

Anfragekörper erforderlich

  • modelstringErforderlich

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

    Maximale Länge
    191
  • promptstringErforderlich

    Nicht leer, maximal 32000 UTF-8-Bytes. OpenAPI maxLength zählt Zeichen, daher wird keine künstliche Zeichengrenze angegeben.

  • sizestringErforderlich

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

  • nintegerOptional

    Ausgelassen oder 0 wird zu 1 normalisiert. Tatsächliches Maximum ist max_n aus image-models; das globale Maximum ist keine Modellfähigkeit.

    Standardwert
    1
    Minimum
    1
    Maximum
    6
  • referencesarrayOptional

    Pro Element nur eines von file_id, asset_id oder url wählen; tatsächliche Anzahl gemäß max_references.

    Maximale Elementanzahl
    14
    Unterfelder von references (1)
    • []objectOptional
      Unterfelder von [] (3)
      • file_idstringOptional

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

      • asset_idstringOptional

        ID eines hochgeladenen Objekts desselben Kontos und Schlüssels.

      • urlstringOptional

        Öffentliche HTTPS-URL ohne userinfo oder fragment; SSRF-geprüft.

        Format
        "uri"
      oneOf-Zweig 1

      In diesem Zweig erforderlich: file_id

      oneOf-Zweig 2

      In diesem Zweig erforderlich: asset_id

      oneOf-Zweig 3

      In diesem Zweig erforderlich: url

  • source_task_idstringOptional

    Optionale Quellaufgabe desselben Schlüssels, nur zur Herkunftsverfolgung; ersetzt references nicht.

    Maximale Länge
    64
  • quote_idstringOptional

    Bei Erstellung gültiges, zur Anfrage passendes Angebot erforderlich; in Angebotsanfragen ignoriert.

Antworten und Fehler

HTTP 200

Kostenvoranschlag für persistente Bilder erfolgreich abgerufen

application/json

Typ
object
Pflichtfelder
pricing_noteidexpires_atreserved_quotaestimated_costcurrency
  • pricing_notestringErforderlich

    Beschreibung der Modellpreise; endgültige Abrechnung anhand bestätigter Messdaten.

  • idstringErforderlich

    Öffentliche Kennung dieses Objekts für den zugehörigen Detailpfad.

  • expires_atintegerErforderlich

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

  • reserved_quotaintegerErforderlich

    Reservierung in Plattform-quota-Einheiten, nicht in Dollar.

  • estimated_costnumberErforderlich

    Geschätzter Verkaufspreis in der Angebotswährung.

  • currencystringErforderlich

    Währung des Kostenvoranschlags/der Abrechnung.

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.