Gemini Omni 1.2 Flash

APIMaster-Gateway-Vertrag für gemini-omni-1.2-flash, geprüft am 2026-11-07. Dies ist nicht die native Google Interactions API. Die Official/Ext-Regeln von 1.1 gelten hier nicht.

OpenAPI 3.1 · Gemini Omni 1.2 Flash

Routen und Authentifizierung

Die aktuelle öffentliche Route ist Kanal 335. Verwenden Sie Authorization: Bearer YOUR_API_KEY und Content-Type: application/json. Modell-/Gruppenrechte, Guthaben und Routenverfügbarkeit gelten weiterhin; eine zusätzliche Kundenfreigabeliste ist nicht veröffentlicht. Keine Kanalnummer an die Modell-ID anhängen. Es gibt keine eigene 1.2-Ext-Route; die Modellauflistung garantiert nicht alle Google-Funktionen.

• POST https://apimaster.ai/v1/videos
• POST https://apimaster.ai/v1/videos/generations
• GET https://apimaster.ai/v1/videos/{task_id}
• GET https://apimaster.ai/v1/videos/{task_id}/content
• GET https://apimaster.ai/v1/video-submissions/by-key
• GET https://apimaster.ai/api/log/token

Parameter und Grenzen

Feld	Typ	Regel
model	string	Exakte öffentliche Modell-ID.
prompt	string	Nichtleere Anweisung in jedem Modus erforderlich, auch bei Bearbeitung und Fortsetzung.
duration	integer	Standard 10; normale Generierung 3–15 ganze Sekunden, Interpolation und neuer Fortsetzungsabschnitt 3–10. Bei Bearbeitung ignoriert.
seconds	integer / string	Kompatibler duration-Alias als Ganzzahl oder Ganzzahlzeichenfolge; duration hat Vorrang.
resolution	string	360p, 720p (Standard), 1080p, 4k, ohne Beachtung der Großschreibung; 2160p entspricht 4k. 1080p/4k werden hochskaliert.
aspect_ratio	string	16:9 als Standard oder 9:16. Andere Zeichenfolgen werden derzeit zu 16:9 normalisiert; nur unterstützte Werte senden.
ratio	string	Alter Seitenverhältnis-Alias, keine Auflösung; aspect_ratio bevorzugen.
size	string	Alter Alias; Vorrang: aspect_ratio, ratio, size.
image_urls	string[]	Öffentliche HTTP(S)-Bild-URLs. Ein Bild ist standardmäßig das Startbild, mehrere sind Referenzen.
first_frame_image	string	Öffentliche URL des ersten Bildes.
last_frame_image	string	Erfordert first_frame_image; Bildproportionen an Ausgabe anpassen.
image_with_roles	object[]	Alternative zu expliziten Bildfeldern. Jedes Objekt enthält url und nichtleere role; first_frame/last_frame sind Anfang/Ende, andere Rollen Referenzen. Ende benötigt Anfang.
video_urls	string[]	Höchstens ein öffentliches Eingabevideo bis 15 Sekunden; standardmäßig Bearbeitung.
omni_reference_task_type	string	auto, edit, extend, reference, text_to_video, image_to_video, reference_to_video. Für Fortsetzung ausdrücklich extend setzen.
extend_from_task_id	string	Ihre erfolgreiche öffentliche task_...-Aufgabe dieses Modells; schließt video_urls aus. Ursprüngliche Route und Anbieterkonto müssen verfügbar bleiben. Keine Google interaction ID.

Bilder und Einzelbilder zusammen höchstens 10. Entweder image_with_roles oder explizite Bildfelder verwenden. Der Anbieter empfiehlt höchstens zwei Figuren mit jeweils drei Bildern. Nur öffentliche direkte HTTP(S)-URLs; kein Base64, Data URL oder multipart. PNG/JPEG und MP4 wurden geprüft. Die Längenprüfung unterstützt MP4/MOV-kompatible Medien und liest höchstens 100 MiB; das ist keine garantierte Uploadgröße des Anbieters. Vollständige Codec-/Größenangaben und ein Byte-Limit je Bild sind nicht veröffentlicht.

Audioreferenzen, audio_urls, Google interaction/conversation-Zustand, metadata, generation_type, system_prompt, temperature, negative_prompt, seed, fps und n sind nicht verfügbar. Negative Vorgaben und gewünschte Geräusche gehören in prompt. Abgeschlossene öffentliche Aufgaben können verkettet werden, aber jedes Eingabevideo bleibt auf 15 Sekunden begrenzt; keine native Google-Sitzung. Unbekannte Felder auf oberster Ebene werden abgewiesen.

JSON-Beispiele ohne Ausführung

Dies sind inaktive JSON-Anfragen, keine Skripte. example.com und Platzhalter-IDs ersetzen. Jede neue Operation erhält einen neuen Schlüssel; Wiederholungen behalten Schlüssel und Inhalt bei. Für den nächsten Schritt die öffentliche ID der abgeschlossenen Unteraufgabe verwenden. Es gibt kein gültiges Audio-Eingabebeispiel.

1. text_to_video

{"model":"gemini-omni-1.2-flash","prompt":"A blue glass sphere rolls slowly across a plain gray table.","duration":3,"resolution":"360p","aspect_ratio":"16:9"}

2. reference_to_video

{"model":"gemini-omni-1.2-flash","prompt":"Animate these geometric references while preserving their shapes and colors.","image_urls":["https://example.com/reference-a.png","https://example.com/reference-b.png"],"omni_reference_task_type":"reference","duration":6,"resolution":"720p","aspect_ratio":"16:9"}

3. first_frame_image / last_frame_image

{"model":"gemini-omni-1.2-flash","prompt":"Make a smooth transition from the first view to the last view.","first_frame_image":"https://example.com/first.png","last_frame_image":"https://example.com/last.png","duration":6,"resolution":"720p","aspect_ratio":"16:9"}

4. image_with_roles

{"model":"gemini-omni-1.2-flash","prompt":"Make a smooth transition between these views.","image_with_roles":[{"url":"https://example.com/first.png","role":"first_frame"},{"url":"https://example.com/last.png","role":"last_frame"}],"duration":6,"resolution":"720p"}

5. edit / video_urls

{"model":"gemini-omni-1.2-flash","prompt":"Change the lighting to sunset while preserving the scene.","video_urls":["https://example.com/input.mp4"],"omni_reference_task_type":"edit","resolution":"720p"}

6. extend / video_urls

{"model":"gemini-omni-1.2-flash","prompt":"Continue the camera movement for three more seconds.","video_urls":["https://example.com/input.mp4"],"omni_reference_task_type":"extend","duration":3,"resolution":"720p"}

7. extend / extend_from_task_id

{"model":"gemini-omni-1.2-flash","prompt":"Continue the previous scene with a gentle camera pan.","extend_from_task_id":"task_YOUR_COMPLETED_TASK","omni_reference_task_type":"extend","duration":3,"resolution":"720p"}

8. edit / extend_from_task_id

{"model":"gemini-omni-1.2-flash","prompt":"Keep the scene but turn the blue sphere yellow.","extend_from_task_id":"task_YOUR_COMPLETED_TASK","omni_reference_task_type":"edit","resolution":"720p"}

Aufgaben, Abfragen und Downloads

Der erste akzeptierte POST liefert HTTP 200 und queued. Alle 5–10 Sekunden abfragen: queued → in_progress → completed/failed; auch vorübergehendes unknown behandeln. url und metadata.url sind geschützte Proxys; mit Bearer herunterladen. Generierungsfehler erscheinen meist als HTTP 200 mit error.code=generation_failed und bereinigter Meldung. Übermittlungsfehler verwenden 4xx/5xx. Timeout oder 5xx beweisen keine Nichtannahme. In den Beispielen sind Identität und Zeit ersetzt.

{"id":"task_REDACTED_EXAMPLE","task_id":"task_REDACTED_EXAMPLE","object":"video","model":"gemini-omni-1.2-flash","status":"queued"}

{"id":"task_REDACTED_COMPLETED_EXAMPLE","task_id":"task_REDACTED_COMPLETED_EXAMPLE","object":"video","model":"gemini-omni-1.2-flash","status":"completed","progress":100,"created_at":1793966808,"url":"https://apimaster.ai/v1/videos/task_REDACTED_COMPLETED_EXAMPLE/content","metadata":{"url":"https://apimaster.ai/v1/videos/task_REDACTED_COMPLETED_EXAMPLE/content"}}

{"id":"task_REDACTED_FAILED_EXAMPLE","task_id":"task_REDACTED_FAILED_EXAMPLE","object":"video","model":"gemini-omni-1.2-flash","status":"failed","progress":100,"created_at":1793966808,"error":{"code":"generation_failed","message":"The generation request failed."}}

Nutzung, Endkosten und Erstattungen

Die Aufgabenabfrage garantiert weder usage noch Modalitätsdetails oder USD. Nach Abgleich steht der endgültige Kundenbetrag in other.final_amount_usd des Verbrauchsprotokolls. GET /api/log/token mit demselben Schlüssel liefert eine begrenzte aktuelle Liste, kein Rechnungsarchiv. Für Kontoverlauf GET /api/log/self ist Kontoauthentifizierung erforderlich; ein Generierungsschlüssel ersetzt sie nicht. other als JSON lesen und other.task_id zuordnen. Bei tatsächlichen Nutzungsdaten können prompt_tokens, completion_tokens sowie other.input_tokens, text_output_tokens, video_output_tokens, token_usage_source, retail_token_prices und group_ratio vorliegen. Eingangstokens sind aggregiert, ohne garantierte Text-/Bild-/Videoaufteilung.

Am 2026-11-07 betragen die Kanal-335-Basistarife je Million Tokens $1.32 Eingang, $7.92 Textausgang, $10.56 Videoausgang, vor Kontofaktoren; aktuelle Modellkarte prüfen. Beim Senden wird geschätzt reserviert, danach mit tatsächlicher Nutzung und eingefrorenen Preisen nachbelastet oder erstattet. Bestätigtes Generierungsversagen erstattet die Reservierung; unklare Annahme garantiert keine sofortige Erstattung. 500,000 quota = USD 1. Anfangsreservierung nicht als Endpreis behandeln und Endbetrag nicht nochmals mit Korrekturbuchungen addieren. Historisches Beispiel: Eingang 39, Text 0, Video 5793, Endbetrag $0.064286; keine neue Festpreisgarantie.

USD = (input_tokens × input_rate
     + text_output_tokens × text_output_rate
     + video_output_tokens × video_output_rate) / 1,000,000

Fortsetzung berechnet Videoausgang nur für den neuen Abschnitt und Eingang für das Referenzvideo; die MP4 enthält beide Teile. Geprüft: 3 Sekunden plus 3 neue ergeben etwa 6 Sekunden, Ausgangstokens für etwa 3 neue Sekunden. Erzeugter Ton gehört zum Videoausgang. Ohne Textdetails behandelt der aktuelle Parser gemeldeten Ausgang als Video. Fehlen gültige Tokens, kann eine verbindliche Kostenquittung verwendet werden, mit token_usage_source=provider_cost_receipt und ohne erfundene Zähler. Fehlen Nutzung und Kosten, läuft der Abgleich weiter. Vollständige Zähler und feste Abrechnungsdauer sind nicht garantiert.

Gateway-Idempotenz und Wiederherstellung

Idempotency-Key: 8–128 sichtbare ASCII-Zeichen ohne Leerraum, kein entsprechendes Körperfeld, kontobezogen. Gleiches Konto/Schlüssel/Anfrage: HTTP 202 und Idempotency-Replayed:true, keine zweite Generierung oder Reservierung. Geänderter Inhalt, Gruppe oder explizite Route: 409 idempotency_conflict. JSON-Schlüsselreihenfolge zählt nicht; Werte, Array-Reihenfolge und ausgelassene/explizite Standardwerte zählen. Nach Verbindungsabbruch versucht das Gateway, den ursprünglichen begrenzten Ablauf samt Speicherung abzuschließen.

{"code":200,"data":{"submission_id":"REDACTED_SUBMISSION_ID","task_id":"task_REDACTED_EXAMPLE","model":"gemini-omni-1.2-flash","status":"accepted","task_ready":true,"same_key_replay_safe":true,"new_submission_safe":false,"next_action":"query_task"}}

GET /v1/video-submissions/by-key mit Originalschlüssel und Bearer liest nur den Beleg: kein Generatoraufruf, keine Anbietersuche nach Schlüssel, keine Geldbewegung. pending/submitting weiter abfragen; accepted mit task_ready=true: task_id abfragen; accepted ohne Bereitschaft: Abgleich abwarten oder Support; acceptance_unknown: nicht automatisch erneut senden, Schlüssel und Referenz aufbewahren; not_accepted: bestätigten Fehler beheben und nur bei erlaubtem Beleg-/Finanzstatus einen neuen Schlüssel verwenden. Alter Schlüssel wiederholt weiterhin das alte Ergebnis. 404 mit retry_safe=false beweist keine Nichtannahme. Mindestens 30 Tage Aufbewahrung, keine automatische Schlüsselwiederverwendung. Wiederholter POST ohne Kundenschlüssel ist eine neue Operation. Dies ist Gateway-Idempotenz, keine native Google/APIMart-Garantie. Ungewisse Originale werden nie automatisch erneut gesendet. Bestätigt akzeptierte und finanziell verbuchte Aufgaben können ohne neue Generierung oder Belastung wiederhergestellt werden.

Nicht verfügbare Funktionen und Kostenschätzung

POST /v1/videos/quote unterstützt dieses Modell NICHT; die Prüfung ist derzeit Seedance-spezifisch. Für Omni gibt es keinen unterstützten kostenlosen Kostenvoranschlag ohne Aufgabe/Generator und keinen eigenen invoice-Vertrag oder /v1/videos/{task_id}/billing-Endbeleg. Anbieterregeln für Moderation und Regionen gelten weiter, einschließlich Einschränkungen für Bearbeitung/Fortsetzung hochgeladener Videos in EEA, Schweiz und Großbritannien. Das verlinkte Schema beschreibt das Gateway; native Beispiele ersetzen nicht APIMaster-IDs, Antworten und Protokolle.

APIMart · Gemini Omni 1.2 Flash