CheaperGen
GoogleTutorial

So verwenden Sie die Gemini Omni Flash-API

Eine Schritt-für-Schritt-Anleitung zur Gemini Omni Flash-API mit Node.js, Python und cURL: einen text zu video-Auftrag absenden, den Status abfragen oder einen Webhook empfangen und anschließend die video herunterladen. Das folgende Beispiel kostet $0,72.

Endpunkte
3
Text zu Video · Bild zu Video · Referenz zu Video
Beispielanfrage
$0,72
Text zu Video
Sprachen
3
Node.js · Python · cURL
Fehlgeschlagene Aufträge
$0
automatisch erstattet
1

API-Schlüssel abrufen

Erstellen Sie ein Konto, laden Sie Guthaben auf und erstellen Sie im Dashboard unter „API-Schlüssel“ einen Schlüssel. Speichern Sie ihn als CHEAPERGEN_API_KEY auf Ihrem Server. Jede Anfrage sendet ihn als Bearer-Token.

So erhalten Sie einen Gemini Omni Flash-API-Schlüssel
2

Wählen Sie einen Gemini Omni Flash-Endpunkt

Jede Aufgabe hat einen eigenen Endpunkt. Alle erwarten einen JSON-Body und geben eine Generierung zurück, deren Status Sie abfragen können.

Gemini Omni Flash API-Endpunkte, erforderliche Eingaben und Preise
AufgabeEndpunktErforderlichAb
Text zu Videogoogle/gemini-omni-flash/text-to-videoprompt$0,089 pro Sekunde
Bild zu Videogoogle/gemini-omni-flash/image-to-videoprompt, image_url$0,089 pro Sekunde
Referenz zu Videogoogle/gemini-omni-flash/reference-to-videoprompt, reference_image_urls$0,089 pro Sekunde
3

Einen text zu video-Auftrag absenden

Dieses Programm übermittelt den Auftrag, fragt alle 3 Sekunden bis zum Abschluss den Status ab und gibt die video-URL aus. Ersetzen Sie Prompt und Einstellungen durch Ihre eigenen.

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/google/gemini-omni-flash/text-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "Ein Jazztrio spielt in einem verrauchten Kellerclub. Die Sängerin beugt sich zum Mikrofon, das Publikum klatscht im Takt.",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 8
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.video.url : job.error);
4

Wichtige Parameter festlegen

Die Einstellungen für google/gemini-omni-flash/text-to-video und ihre Auswirkungen auf den Preis.

Gemini Omni Flash Text zu Video Parameter und ihre Auswirkungen auf den Preis
ParameterTyp · StandardwertBeschreibungPreisauswirkung
aspect_ratiostring (enum) · 16:9Quer- oder Hochformat.
16:9 · 9:16
Ja
resolutionstring (enum) · 720p720p (1080p und 4K sind noch nicht verfügbar).
720p
720p: $0,0927 pro Sekunde
durationinteger (enum) · 8Clip-Länge: 4, 6, 8 oder 10 Sekunden.
4 · 6 · 8 · 10
4 s: $0,0927 pro Sekunde
8 s: $0,089 pro Sekunde
seedintegerVerwenden Sie denselben Seed und dieselben Einstellungen, um ein Ergebnis zu reproduzieren. Leer lassen für Zufallswerte.Keine

Weitere Gemini Omni Flash-Endpunkte verwenden dieselbe Struktur, aber jeweils eigene Eingabefelder:

POST /api/v1/run/google/gemini-omni-flash/image-to-video

{
  "prompt": "Das Standbild erwacht zum Leben: Dampf steigt auf, der Koch dreht sich um und lächelt in die Kamera.",
  "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 8
}

POST /api/v1/run/google/gemini-omni-flash/reference-to-video

{
  "prompt": "@Image1 betritt den Laden von @Image2 aus und nimmt die Tasche von @Image3",
  "reference_image_urls": [
    "https://cdn.cheapergen.com/samples/reference-1.jpg",
    "https://cdn.cheapergen.com/samples/reference-2.jpg",
    "https://cdn.cheapergen.com/samples/reference-3.jpg"
  ],
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 8
}
5

Ergebnis abrufen

Ein Auftrag wechselt von queued zu running und anschließend zu succeeded, failed oder canceled. Fragen Sie GET /api/v1/generations/{id} ab oder übergeben Sie webhook_url; dann senden wir Ihnen das Ergebnis per POST. Laden Sie die Ausgabe herunter und speichern Sie sie selbst.

200 — succeeded
{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "google/gemini-omni-flash",
  "endpoint": "google/gemini-omni-flash/text-to-video",
  "mode": "text-to-video",
  "status": "succeeded",
  "input": {
    "prompt": "Ein Jazztrio spielt in einem verrauchten Kellerclub. Die Sängerin beugt sich zum Mikrofon, das Publikum klatscht im Takt.",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 8
  },
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.com/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4",
      "duration": 5,
      "width": 1280,
      "height": 720
    }
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}
Webhook-Signaturen prüfen
6

Preis vor der Ausführung abfragen

Der Angebotsendpunkt ist kostenlos und erfordert keinen Schlüssel. Er gibt den Preis, der offizielle Preis und Ihren Rabatt genau für die übermittelten Eingaben zurück.

curl -X POST https://cheapergen.com/api/v1/quote/google/gemini-omni-flash/text-to-video \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Ein Jazztrio spielt in einem verrauchten Kellerclub. Die Sängerin beugt sich zum Mikrofon, das Publikum klatscht im Takt.","aspect_ratio":"16:9","resolution":"720p","duration":8}'
API-Fehler und was Sie tun können
StatusCodeBedeutung
400invalid_requestEin Parameter fehlt oder liegt außerhalb des zulässigen Bereichs – die Meldung nennt ihn.
401unauthorizedAPI-Schlüssel fehlt, ist fehlerhaft formatiert oder wurde widerrufen.
402insufficient_balanceIhr Guthaben reicht nicht für den angebotenen Preis. Laden Sie es auf oder aktivieren Sie die automatische Aufladung.
429rate_limitedZu viele Anfragen oder gleichzeitig laufende Generierungen. Warten Sie kurz und versuchen Sie es erneut.
502upstream_errorDie Verarbeitung durch das Modell ist fehlgeschlagen. Der reservierte Betrag wird erstattet; Sie können es erneut versuchen.
503model_unavailableDerzeit ist kein geeigneter Verarbeitungsweg verfügbar. Versuchen Sie es später erneut oder wählen Sie ein anderes Modell.
Vollständige Gemini Omni Flash-API-Dokumentation

FAQ

Gemini Omni Flash-API: häufige Fragen

Nein. Die API verwendet einfaches HTTPS mit JSON. Die Beispiele für Node.js (fetch) und Python (requests) auf dieser Seite sind vollständige Programme. Jede Sprache, die HTTP-Anfragen senden kann, funktioniert.

Ja. Fügen Sie „webhook_url“ in den Anfrage-Body ein. Wir senden die abgeschlossene Generierung dann signiert an diese Adresse, mit dem Header CheaperGen-Signature (HMAC-SHA256 aus Zeitstempel und rohem Body). GET /api/v1/generations/{id} zum Abfragen des Status funktioniert ebenfalls.

Übergeben Sie öffentliche URLs in "image_url", "end_image_url", "reference_image_urls". Dateien ohne öffentliche URL können Sie zuerst mit POST /api/v1/uploads hochladen. Der Aufruf gibt eine URL zurück, die Sie in der Anfrage verwenden.

Text zu Video kostet ab $0,089 pro Sekunde; die Beispielanfrage auf dieser Seite kostet $0,72, 13% unter der offizielle Preis. Fehlgeschlagene Generierungen werden automatisch erstattet.