Rivya AI Docs
Modell-API-Seiten

Gemini Omni 1.1 Flash API-Integration

Nutze Gemini Omni 1.1 Flash über Rivya Public API v1 mit Model-ID gemini-omni-flash-1-1, unterstützten Eingaben, Parametern, Files-API-Regeln, Credits und Response-Beispielen.

Über API verfügbarText oder URL bereit; Referenzmodi nutzen Files APIVideo
API-Modell-ID

gemini-omni-flash-1-1

Eingaben

text, file

Files API

Für Referenzmodi erforderlich

Basis-Credits

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⌉

Fähigkeit

Video

Abrechnung

FIXED

Prompt-Limit

20000 Zeichen

Request-Kontrakt

Sende die Modell-ID auf Top-Level. Modellspezifische Controls gehören in params.

KeyTypErforderlichStandardBeschreibung
modelstringJagemini-omni-flash-1-1Verwende gemini-omni-flash-1-1 als API-Modell-ID.
promptstringJa-Maximal 20000 Zeichen für dieses Modell.
paramsobjectNein-Modellspezifisches Parameterobjekt. Die erlaubten Keys stehen in den Zeilen darunter.
client_request_idstringNein-Optionale Client-ID, um Requests in deinem System nachzuverfolgen.

Modellparameter

KeyTypErforderlichStandardBereichOptionenBeschreibung
reference_modeselectNeinreference-reference, framesReferenzmodus
resolutionselectNein720p-360p, 720p, 1080p, 4kAuflösung
durationselectNein4-4, 6, 8, 10Dauer
aspect_ratioselectNein16:9-16:9, 9:16Seitenverhältnis
seednumberNein-min 0 / max 2147483647-Lass das Feld leer, um jedes Mal ein neues zufälliges Ergebnis zu erhalten. Wenn du dieselbe Ganzzahl erneut verwendest, lässt sich ein früheres Ergebnis leichter reproduzieren oder feinabstimmen. Es bleibt nur dann näher am Original, wenn Prompt und andere wichtige Einstellungen ebenfalls ähnlich bleiben, und es ist keine garantierte 1:1-Übereinstimmung.
video_startnumberNein-min 0 / max 30-Videoanfang (Sekunden)
video_endsnumberNein-min 0 / max 30-Videoende (Sekunden)

Upload-Richtlinie

Lade zuerst Referenzdateien hoch und setze dann die zurückgegebene URL und den durationToken in params.referenceMediaItems.

Referenzregel

Referenzmaterial: Nutze bis zu sieben Bilder mit je 20 MB oder ein Video mit höchstens 95 MB und 30 Sekunden zusammen mit bis zu fünf Bildern. Der gewählte Videoabschnitt darf höchstens 10 Sekunden lang sein. Audio- und Figuren-IDs werden nicht unterstützt. Der Frame-Modus akzeptiert ein Startbild oder ein Start-Ende-Paar ohne weitere Referenzen.

Max. Dateien

7

Akzeptierte Dateitypen

image, video

Duration Token

Video- und Audioreferenzen sollten durationToken aus /api/v1/files mitführen, wenn eine Dauerprüfung erforderlich ist.

kindMax. GrößeMIME-Typen
image20 MBimage/jpeg, image/png, image/webp
video95 MBvideo/mp4, video/quicktime

Minimalrequest

{
  "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
  }
}

Request mit Referenzdatei

{
  "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"
      }
    ]
  }
}

Create-Response

Der Create-Endpunkt gibt eine öffentliche Task-ID zurück. Frage den Status-Endpunkt ab, bis der Task erfolgreich ist oder fehlschlägt.

{
  "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
}

Häufige Fehler

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Einige Modi benötigen Referenz-Uploads über Files API.