Documentazione

Riferimento API

Ottieni un preventivo per video persistente

POST/v1/video-quotes

retention=persistent: preventivo secondo modalità e fotogrammi ospitati del catalogo. Se disabilitato, la route restituisce direttamente 404. Scadenza o variazione di prezzo richiedono nuova conferma.

Autenticazione e autorizzazioni

Usa la chiave GloopAPI corrente. Modelli, funzionalità e autorizzazioni disponibili dipendono dal relativo catalogo e dalla documentazione dell'endpoint.

Authorization: Bearer $GLOOP_API_KEY

Schemi di autenticazione: BearerAuth

Richiesta

Corpo della richiesta · application/json

Tipo
object
Campi obbligatori
modelprompt
Proprietà aggiuntive
false

Corpo della richiesta obbligatorio

  • modestringFacoltativo

    Obbligatorio per persistent.

    Enumerazione
    ["text_to_video","image_to_video"]
  • retentionstringFacoltativo

    persistent usa l'area persistente; se omesso, attività ordinaria.

  • quote_idstringFacoltativo

    Una nuova richiesta persistent richiede prima la conferma di un preventivo valido di video-quotes.

  • start_frameobjectFacoltativo

    Obbligatorio per immagine-video persistent: file ospitato della stessa Key. Vietato per testo-video.

    Campi figli di start_frame (1)
    • file_idstringObbligatorio

      ID pubblico del file ospitato dello stesso account e della stessa Key.

    Ramo allOf 1

    Tipo: object

    Obbligatorio in questo ramo: file_id

    • file_idstringObbligatorio

      ID pubblico del file ospitato dello stesso account e della stessa Key.

  • end_frameobjectFacoltativo

    Fotogramma finale facoltativo per persistent, se supportato.

    Campi figli di end_frame (1)
    • file_idstringObbligatorio

      ID pubblico del file ospitato dello stesso account e della stessa Key.

    Ramo allOf 1

    Tipo: object

    Obbligatorio in questo ramo: file_id

    • file_idstringObbligatorio

      ID pubblico del file ospitato dello stesso account e della stessa Key.

  • webhook_endpoint_idstringFacoltativo

    Le attività ordinarie possono riferire un ricevitore configurato nella console; vietato per persistent.

  • modelstringObbligatorio

    ID pubblico del modello nel catalogo della Key corrente; non garantisce la disponibilità di vecchi modelli del servizio.

  • promptstringObbligatorio

    Prompt di generazione.

    Lunghezza minima
    1
    Lunghezza massima
    2500
  • durationintegerFacoltativo

    Durata secondo modello; usa la combinazione completa di video-models mode.presets, senza prodotto cartesiano. Wan Turbo non supporta questo campo; nessun valore predefinito uniforme.

  • image_urlstringFacoltativo

    Fotogramma iniziale HTTPS secondo modello, solo attività ordinarie; vietato per persistent.

  • end_image_urlstringFacoltativo

    Fotogramma finale HTTPS secondo modello, solo attività ordinarie; vietato per persistent.

  • resolutionstringFacoltativo

    Risoluzione del preset del modello.

  • aspect_ratiostringFacoltativo

    Rapporto d'aspetto del preset del modello.

  • generate_audiobooleanFacoltativoConsente null

    Dipende dal modello; usa la politica audio e i presets della modalità. Non presumere che tutti i modelli generino audio.

Risposte ed errori

HTTP 200

Preventivo per video persistente ottenuto

application/json

Tipo
object
Campi obbligatori
idexpires_atrequest_hashpricing_kindcurrencyreserved_quotareserved_amountestimated_final_amountsettlement_note
  • idstringObbligatorio

    Identificatore pubblico dell'oggetto, usato nel relativo percorso dei dettagli.

  • expires_atintegerObbligatorio

    Scadenza in secondi Unix; 0 indica nessuna scadenza fissa.

  • request_hashstringObbligatorio

    Riepilogo della richiesta normalizzata che vincola preventivo e creazione; non è la chiave di richiesta idempotente.

  • pricing_kindstringObbligatorio

    Modalità di prezzo effettivamente usata per questo preventivo.

  • currencystringObbligatorio

    Valuta del preventivo/della contabilità.

  • reserved_quotaintegerObbligatorio

    Prenotazione in unità quota della piattaforma, non in dollari.

  • reserved_amountstringObbligatorio

    Prenotazione massima, stringa nella valuta del preventivo.

  • estimated_final_amountstringObbligatorioConsente null

    Importo finale stimato come stringa; null indica non determinabile prima della generazione.

  • settlement_notestringObbligatorio

    Descrizione della misurazione e dell'addebito effettivi.

HTTP 400

Campi o parametri della richiesta non validi.

application/json

Tipo
object
Campi obbligatori
error

HTTP 401

Key assente, non valida, scaduta o revocata.

application/json

Tipo
object
Campi obbligatori
error

HTTP 403

Autorizzazioni IP, account, modello o strumento insufficienti.

application/json

Tipo
object
Campi obbligatori
error

HTTP 404

Oggetto/funzionalità non disponibile o disabilitata.

application/json

Tipo
object
Campi obbligatori
error

HTTP 409

Conflitto di idempotenza/preventivo, oggetto non pronto o ancora referenziato.

application/json

Tipo
object
Campi obbligatori
error

HTTP 429

Limite di frequenza delle richieste/della coda.

application/json

Tipo
object
Campi obbligatori
error

HTTP 500

Errore interno di autenticazione o storage dei dati.

application/json

Tipo
object
Campi obbligatori
error

HTTP 503

Servizio, prezzi o storage non disponibile.

application/json

Tipo
object
Campi obbligatori
error

Note sull'endpoint

Questi parametri illustrano soltanto un preset completo. Copia l'intero preset (duration, resolution, aspect_ratio, generate_audio) dal catalogo video-models della Key corrente per il model/mode scelto. Non sostituire solo il modello e non combinare preset diversi.