Documentazione Rivya AI
Pagine API per modello

Integrazione API di Gemini Omni 1.1 Flash

Usa Gemini Omni 1.1 Flash tramite Rivya Public API v1 con model id gemini-omni-flash-1-1, input supportati, parametri, regole Files API, crediti ed esempi di risposta.

Disponibile via APITesto o URL pronti; le modalità di riferimento usano Files APIVideo
ID modello API

gemini-omni-flash-1-1

Input

text, file

Files API

Richiesto per le modalità con riferimento

Crediti base

per_video · 4=45 · 6=60 · 8=75 · 10=90 · 4k_4=105 · 4k_6=120 · 4k_8=135 · 4k_10=150 · withVideo=120 · withVideo4k=180 · ⌈total⌉

Capacità

Video

Fatturazione

FIXED

Limite prompt

20000 caratteri

Contratto della richiesta

Invia l'ID modello al livello superiore. I controlli specifici del modello vanno in params.

KeyTipoObbligatorioPredefinitoDescrizione
modelstringgemini-omni-flash-1-1Usa gemini-omni-flash-1-1 come ID modello API.
promptstring-Massimo 20000 caratteri per questo modello.
paramsobjectNo-Oggetto parametri specifico del modello. Usa le righe sotto per le key consentite.
client_request_idstringNo-ID client facoltativo per tracciare le richieste nel tuo sistema.

Parametri del modello

KeyTipoObbligatorioPredefinitoIntervalloOpzioniDescrizione
reference_modeselectNoreference-reference, framesModalità riferimento
resolutionselectNo720p-360p, 720p, 1080p, 4kRisoluzione
durationselectNo4-4, 6, 8, 10Durata
aspect_ratioselectNo16:9-16:9, 9:16Rapporto d'aspetto
seednumberNo-min 0 / max 2147483647-Lascialo vuoto per ottenere ogni volta un nuovo risultato casuale. Riutilizzare lo stesso numero intero rende più semplice riprodurre o rifinire un risultato precedente. Il risultato resta più vicino solo quando anche il prompt e le altre impostazioni chiave rimangono simili, e non garantisce una corrispondenza 1:1.
video_startnumberNo-min 0 / max 30-Inizio video (secondi)
video_endsnumberNo-min 0 / max 30-Fine video (secondi)

Regola di upload

Carica prima i file di riferimento, poi inserisci l'URL restituito e il durationToken dentro params.referenceMediaItems.

Regola di riferimento

Materiali di riferimento: Usa fino a sette immagini da 20 MB ciascuna, oppure un video fino a 95 MB e 30 secondi con al massimo cinque immagini. Il segmento selezionato non può superare 10 secondi. Gli ID di risorse audio e personaggi non sono supportati. La modalità fotogrammi accetta un’immagine iniziale o una coppia inizio/fine, senza altri riferimenti.

File massimi

7

Tipi di file accettati

image, video

Duration token

I riferimenti video e audio devono includere durationToken da /api/v1/files quando è richiesta la verifica della durata.

kindDimensione massimaTipi MIME
image20 MBimage/jpeg, image/png, image/webp
video95 MBvideo/mp4, video/quicktime

Richiesta minima

{
  "model": "gemini-omni-flash-1-1",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "reference_mode": "reference",
    "resolution": "720p",
    "duration": "4",
    "aspect_ratio": "16:9",
    "seed": 0,
    "video_start": 0,
    "video_ends": 0
  }
}

Richiesta con file di riferimento

{
  "model": "gemini-omni-flash-1-1",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "reference_mode": "reference",
    "resolution": "720p",
    "duration": "4",
    "aspect_ratio": "16:9",
    "seed": 0,
    "video_start": 0,
    "video_ends": 0,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Risposta di creazione

L'endpoint di creazione restituisce un ID task pubblico. Interroga l'endpoint di stato finché il task riesce o fallisce.

{
  "id": "task_gemini_omni_flash_1_1_example",
  "status": "queued",
  "model": "gemini-omni-flash-1-1",
  "reserved_credits": 45,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Alcune modalità richiedono upload di riferimento tramite Files API.