Documentazione

Riferimento API

Elenca funzionalità dell'area video

GET/v1/video-models

Restituisce per modalità presets eseguibili e limiti dei fotogrammi. Usa solo presets completi, senza mescolare modalità.

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

Risposte ed errori

HTTP 200

Funzionalità dell'area video ottenute

application/json

Tipo
object
Campi obbligatori
dataworkspace_enabledupload_enabledfile_storage_enabled
  • dataarrayObbligatorio

    Array dei dati della pagina/del catalogo corrente.

    Campi figli di data (1)
    • []objectFacoltativo
      Campi figli di [] (6)
      • idstringObbligatorio

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

      • namestringObbligatorio

        Nome leggibile dall'utente.

      • capability_versionstringObbligatorio

        Versione delle funzionalità di questo modello pubblico.

      • modesarrayObbligatorio

        Modalità eseguibili del modello con le rispettive combinazioni complete di parametri.

        Campi figli di modes (1)
        • []objectFacoltativo
          Campi figli di [] (9)
          • modestringObbligatorio

            Modalità di esecuzione.

          • presetsarrayObbligatorio

            Combinazione completa di parametri eseguibile; non creare prodotti cartesiani tra combinazioni.

            Campi figli di presets (1)
            • []objectFacoltativo
              Campi figli di [] (4)
              • durationintegerFacoltativoConsente null

                Durata in secondi del preset del modello.

              • resolutionstringFacoltativo

                Risoluzione del preset del modello.

              • aspect_ratiostringFacoltativo

                Rapporto d'aspetto del preset del modello.

              • generate_audiobooleanFacoltativoConsente null

                Indica se il preset del modello genera audio.

          • audio_policystringObbligatorio

            Politica del campo audio della modalità corrente.

          • aspect_policystringObbligatorio

            Politica del campo rapporto d'aspetto della modalità corrente.

          • duration_policystringObbligatorio

            Politica del campo durata della modalità corrente.

          • prompt_max_charsintegerObbligatorio

            Numero massimo di caratteri Unicode del prompt per questa modalità.

          • start_frameobjectFacoltativo

            Limiti del fotogramma iniziale della modalità corrente.

            Campi figli di start_frame (5)
            • requiredbooleanObbligatorio

              Indica se questa modalità richiede il fotogramma.

            • max_bytesintegerObbligatorio

              Dimensione massima in byte del file per questo fotogramma.

            • max_pixelsintegerObbligatorio

              Numero massimo totale di pixel di questo fotogramma.

            • max_edgeintegerObbligatorio

              Numero massimo di pixel su un lato del fotogramma.

            • content_typesarrayObbligatorio

              Tipi MIME immagine consentiti per questo fotogramma.

              Campi figli di content_types (1)
              • []stringFacoltativo
            Ramo allOf 1

            Tipo: object

            Obbligatorio in questo ramo: required, max_bytes, max_pixels, max_edge, content_types

            • requiredbooleanObbligatorio

              Indica se questa modalità richiede il fotogramma.

            • max_bytesintegerObbligatorio

              Dimensione massima in byte del file per questo fotogramma.

            • max_pixelsintegerObbligatorio

              Numero massimo totale di pixel di questo fotogramma.

            • max_edgeintegerObbligatorio

              Numero massimo di pixel su un lato del fotogramma.

            • content_typesarrayObbligatorio

              Tipi MIME immagine consentiti per questo fotogramma.

              Campi figli di content_types (1)
              • []stringFacoltativo
          • end_frameobjectFacoltativo

            Limiti del fotogramma finale della modalità corrente.

            Campi figli di end_frame (5)
            • requiredbooleanObbligatorio

              Indica se questa modalità richiede il fotogramma.

            • max_bytesintegerObbligatorio

              Dimensione massima in byte del file per questo fotogramma.

            • max_pixelsintegerObbligatorio

              Numero massimo totale di pixel di questo fotogramma.

            • max_edgeintegerObbligatorio

              Numero massimo di pixel su un lato del fotogramma.

            • content_typesarrayObbligatorio

              Tipi MIME immagine consentiti per questo fotogramma.

              Campi figli di content_types (1)
              • []stringFacoltativo
            Ramo allOf 1

            Tipo: object

            Obbligatorio in questo ramo: required, max_bytes, max_pixels, max_edge, content_types

            • requiredbooleanObbligatorio

              Indica se questa modalità richiede il fotogramma.

            • max_bytesintegerObbligatorio

              Dimensione massima in byte del file per questo fotogramma.

            • max_pixelsintegerObbligatorio

              Numero massimo totale di pixel di questo fotogramma.

            • max_edgeintegerObbligatorio

              Numero massimo di pixel su un lato del fotogramma.

            • content_typesarrayObbligatorio

              Tipi MIME immagine consentiti per questo fotogramma.

              Campi figli di content_types (1)
              • []stringFacoltativo
          • cancel_policystringFacoltativo

            Politica di annullamento; la richiesta non garantisce l'annullamento effettivo né il rimborso.

      • cancel_policystringObbligatorio

        Politica di annullamento; la richiesta non garantisce l'annullamento effettivo né il rimborso.

      • pricing_kindsarrayObbligatorio

        Modalità di prezzo consentite da questo modello.

        Campi figli di pricing_kinds (1)
        • []stringFacoltativo
  • workspace_enabledbooleanObbligatorio

    Disponibilità di nuove attività nell'area corrente; non significa che gli oggetti storici siano eliminati.

  • upload_enabledbooleanObbligatorio

    Indica se il servizio abilita il caricamento delle immagini di riferimento.

  • file_storage_enabledbooleanObbligatorio

    Indica se il servizio abilita lo storage dei file ospitati.

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