Dokumentation

API-Referenz

Kostenvoranschlag für persistente Videos abrufen

POST/v1/video-quotes

retention=persistent: Angebot nach Katalogmodi und gehosteten Frames. Bei deaktiviertem Schalter direkt 404. Ablauf oder Preisänderung erfordert erneute Bestätigung.

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

Anfragekörper erforderlich

  • modestringOptional

    Für persistent erforderlich.

    Aufzählung
    ["text_to_video","image_to_video"]
  • retentionstringOptional

    persistent verwendet den persistenten Arbeitsbereich; ohne Angabe normale Aufgabe.

  • quote_idstringOptional

    Neue persistent-Anfragen erfordern vorherige Bestätigung eines gültigen video-quotes-Angebots.

  • start_frameobjectOptional

    Für persistent Bild-zu-Video erforderlich: gehostete Datei derselben Key. Bei Text-zu-Video verboten.

    Unterfelder von start_frame (1)
    • file_idstringErforderlich

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

    allOf-Zweig 1

    Typ: object

    In diesem Zweig erforderlich: file_id

    • file_idstringErforderlich

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

  • end_frameobjectOptional

    Optionaler Endframe für persistent, sofern unterstützt.

    Unterfelder von end_frame (1)
    • file_idstringErforderlich

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

    allOf-Zweig 1

    Typ: object

    In diesem Zweig erforderlich: file_id

    • file_idstringErforderlich

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

  • webhook_endpoint_idstringOptional

    Gewöhnliche Aufgaben dürfen einen in der Konsole konfigurierten Empfänger referenzieren; bei persistent verboten.

  • modelstringErforderlich

    Öffentliche Modell-ID aus dem aktuellen Schlüsselkatalog; garantiert nicht, dass historische Dienstmodelle weiterhin verfügbar sind.

  • promptstringErforderlich

    Generierungsprompt.

    Mindestlänge
    1
    Maximale Länge
    2500
  • durationintegerOptional

    Modellabhängige Sekundenanzahl. Vollständige Kombination aus video-models mode.presets verwenden, kein kartesisches Produkt bilden. Wan Turbo unterstützt dieses Feld nicht; kein einheitlicher Standardwert.

  • image_urlstringOptional

    Modellabhängiger HTTPS-Startframe nur für normale Aufgaben; bei persistent verboten.

  • end_image_urlstringOptional

    Modellabhängiger HTTPS-Endframe nur für normale Aufgaben; bei persistent verboten.

  • resolutionstringOptional

    Auflösungswert aus dem Modell-preset.

  • aspect_ratiostringOptional

    Seitenverhältnis aus dem Modell-preset.

  • generate_audiobooleanOptionalErlaubt null

    Modellabhängig; Audiorichtlinie und presets des Modus verwenden. Nicht annehmen, dass alle Modelle Audio generieren.

Antworten und Fehler

HTTP 200

Kostenvoranschlag für persistente Videos erfolgreich abgerufen

application/json

Typ
object
Pflichtfelder
idexpires_atrequest_hashpricing_kindcurrencyreserved_quotareserved_amountestimated_final_amountsettlement_note
  • idstringErforderlich

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

  • expires_atintegerErforderlich

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

  • request_hashstringErforderlich

    Zusammenfassung der normalisierten Anfrage zur Bindung von Kostenvoranschlag und Erstellung; kein Idempotenz-Anfrageschlüssel.

  • pricing_kindstringErforderlich

    Tatsächlich verwendete Preismethode dieses Kostenvoranschlags.

  • currencystringErforderlich

    Währung des Kostenvoranschlags/der Abrechnung.

  • reserved_quotaintegerErforderlich

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

  • reserved_amountstringErforderlich

    Maximaler Reservierungsbetrag als Zeichenfolge in der Angebotswährung.

  • estimated_final_amountstringErforderlichErlaubt null

    Geschätzter endgültiger Betrag als Zeichenfolge; null bedeutet vor der Generierung nicht bestimmbar.

  • settlement_notestringErforderlich

    Beschreibung der tatsächlichen Messung und 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

Hinweise zum Endpunkt

Diese Parameter veranschaulichen lediglich ein vollständiges preset. Kopieren Sie das gesamte preset (duration, resolution, aspect_ratio, generate_audio) für das gewählte model/mode aus dem video-models-Katalog des aktuellen Schlüssels; nicht nur das Modell ersetzen oder presets mischen.

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