Veo API-Zugriff wirkt einfach, wenn man nur den Modellnamen liest. In der Produktion ist es jedoch ein Video-Workflow mit Modell-Lifecycle-Prüfungen, sekundengenauer Preisgestaltung, asynchronen Operationen, Auflösungsoptionen, Wiederholungs-/Retry-Kosten und Observability auf Routenebene. Wenn Ihr Team Veo mit Seedance, Sora-ähnlichen Routen oder einem anderen Videomodell hinter einem einzigen Gateway vergleicht, sollten Sie den Zugriff als Checkliste und nicht als einen einzeiligen API-Tausch behandeln.
Dieser Leitfaden wurde am 17. Juni 2026 Asia/Shanghai anhand der Veo-Video-Dokumentation von Google Gemini API, der Preisübersicht für Veo 3.1 von Google, eines frischen Ahrefs-MCP-Laufs und eines Live-Snapshots des Flatkey-Preisverzeichnisses überprüft. Das Ziel ist nicht zu behaupten, dass heute schon jede Route produktionsbereit ist. Das Ziel ist zu zeigen, was Sie genau verifizieren müssen, bevor Sie abrechenbare Video-Jobs über einen Multi-Provider-Router senden.
Schnelle Antwort: Was Sie für den Veo-API-Zugriff prüfen sollten
Bevor Sie den Veo-API-Zugriff für Produktionsverkehr freigeben, bestätigen Sie diese sieben Punkte:
- Offizielle Modell-ID: Entscheiden Sie, ob der Workflow
veo-3.1-generate-preview,veo-3.1-fast-generate-previewoderveo-3.1-lite-generate-previewbenötigt. - Lebenszyklusstatus: Vermeiden Sie ältere Veo-3.0- und Veo-2.0-IDs, sofern Sie keine kurze Migration durchführen, da Google deren Abschaltung für den 30. Juni 2026 angibt.
- Preiseinheit: Normalisieren Sie Veo nach Sekunden, Auflösung und Variante, bevor Sie es mit Videoanbietern mit Token-/Ressourcenpaketen vergleichen.
- Async-Job-Pfad: Protokollieren Sie den Operationsnamen, den Polling-Status, die finale Videoanzahl, Dauer, Auflösung, Anzahl der Wiederholungsversuche und den Fehlergrund.
- Flatkey-Katalogzeile: Überprüfen Sie die exakte Modellzeile, die Endpunktfamilie, die Gruppe, das Preislabel und den Verfügbarkeitsstatus an dem Tag, an dem Sie den Verkehr routen.
- Fallback-Regel: Legen Sie fest, wann ein fehlgeschlagener Veo-Job auf einen anderen Pfad wechseln darf und wann er aus Qualitäts- oder Budgetgründen hart fehlschlagen muss.
- Nachweis der Nutzung: Führen Sie einen kleinen Test aus und bestätigen Sie, dass das Dashboard das ausgewählte Modell, den Pfad, den Status, die abrechenbare Einheit und den Kostenverantwortlichen anzeigt.
Das ist die praktische Version des Veo-API-Zugriffs: nicht nur „Kann ich Veo aufrufen“, sondern „Kann ich nachweisen, welcher Video-Pfad ausgeführt wurde, was er gekostet hat und was passiert, wenn er fehlschlägt“.
Veo API-Zugriff-Checkliste
| Checklistenpunkt | Warum das wichtig ist | Zu speichernder Nachweis |
|---|---|---|
| Model-ID | Veo-Varianten sind bei Kosten, Latenz, Auflösung oder Routensupport nicht austauschbar. | Offizielle Google-Model-ID plus die passende Flatkey-Zeile. |
| Endpunktfamilie | Eine Video-Route verhält sich möglicherweise nicht wie eine Chat-Vervollständigung, selbst wenn das Gateway eine OpenAI-kompatible Oberfläche bereitstellt. | Endpunkttyp, Anfragevorlage, akzeptierte Parameter und Antwortform. |
| Preiseinheit | Veo wird pro Sekunde gelistet, während andere Videoanbieter Tokens, generierte Medien oder Ressourcenpakete verwenden können. | Variante, Auflösung, erwartete Sekunden, Wiederholungsrichtlinie und Datum der Preisquelle. |
| Protokollierung asynchroner Operationen | Die Veo-Generierung verwendet einen Submit-und-Poll-Ablauf, sodass eine Benutzeraktion mehrere interne Ereignisse erzeugen kann. | Operations-ID, Poll-Versuche, Endstatus, Metadaten des generierten Videos und Anzahl der Wiederholungen. |
| Verfügbarkeitsstatus | Eine Katalogzeile ist nicht dasselbe wie eine erfolgreiche Produktionsroute. | Dashboard-Status, Zeitpunkt der letzten Prüfung, Testantwort und Eintrag im Nutzungsprotokoll. |
| Fallback-Grenze | Das Umschalten von Videomodellen kann Stil, Dauer, Qualität, Richtlinienverhalten und Kosten verändern. | Genehmigte Fallback-Matrix und Fail-Closed-Bedingungen. |
Bestätigen Sie das offizielle Veo-Modell und den Lifecycle
Die Dokumentation der Gemini API von Google verwendet derzeit veo-3.1-generate-preview in den Veo-Generierungsbeispielen. Die Preistabelle listet drei Veo-3.1-Preview-IDs auf: veo-3.1-generate-preview, veo-3.1-fast-generate-preview und veo-3.1-lite-generate-preview. Dies ist der erste Ansatzpunkt für eine Überprüfung des Veo API-Zugriffs, da ein Gateway-Katalog gleichzeitig ältere IDs, Aliase und anbieterspezifische Bezeichnungen enthalten kann.
Der Lifecycle ist ebenso wichtig wie die aktuelle ID. Auf der Preiseseite von Google, die für diesen Artikel geprüft wurde, wird darauf hingewiesen, dass die Veo-3-Modelle veo-3.0-generate-001 und veo-3.0-fast-generate-001 veraltet sind und ihre Abschaltung für den 30. Juni 2026 geplant ist. Außerdem heißt es dort, dass Veo 2 veo-2.0-generate-001 veraltet ist und die gleiche Abschaltung am 30. Juni 2026 geplant ist. Wenn ein älteres Codebeispiel, eine gespeicherte Route oder ein Dashboard-Favorit noch darauf verweist, behandeln Sie dies als Migrationsaufgabe und nicht als freigegebenen Zugriffspfad.
Normalisieren Sie die Veo-API-Preisgestaltung, bevor Sie Routen vergleichen
Für den Veo-API-Zugriff ist die Listenpreisangabe nur dann sinnvoll, wenn Sie die Anfrage normalisieren. Googles aktuelle kostenpflichtige Veo-3.1-Preisgestaltung wird pro Sekunde in USD angegeben, mit unterschiedlichen Zeilen für die Varianten Standard, Fast und Lite.
| Veo 3.1 Variante | Offizielle Modell-ID | Preisprüfung | Planungshinweis |
|---|---|---|---|
| Standard | veo-3.1-generate-preview |
$0.40/Sek. bei 720p oder 1080p; $0.60/Sek. bei 4K. | Verwenden Sie dies, wenn Qualitätsanforderungen die höhere Standardzeile rechtfertigen. |
| Fast | veo-3.1-fast-generate-preview |
$0.10/Sek. bei 720p; $0.12/Sek. bei 1080p; $0.30/Sek. bei 4K. | Testen Sie Ausgabequalität und Latenz, bevor Sie Benutzerjobs hierüber routen. |
| Lite | veo-3.1-lite-generate-preview |
$0.05/Sek. bei 720p; $0.08/Sek. bei 1080p; 4K wird nicht unterstützt. | Nützlich für kostengünstigere Entwürfe, wenn 4K nicht erforderlich ist. |
Googles Preisseite weist außerdem darauf hin, dass Ihnen nur dann Gebühren berechnet werden, wenn das Video erfolgreich generiert wird. Das macht das Protokollieren von Wiederholungen jedoch nicht überflüssig. Ein fehlgeschlagener Vorgang, eine geänderte Prompt oder ein vom Nutzer angeforderter erneuter Lauf kann später dennoch einen weiteren kostenpflichtigen Auftrag erzeugen. Ihre Checkliste für den Veo-API-Zugriff sollte Dauer, Auflösung, Variante, Erfolgsstatus und Wiederholungsanzahl für jede Anfrage enthalten.
Wenn Sie Veo mit anderen Anbietern vergleichen, verwenden Sie den umfassenderen Preisvergleich für KI-Video-Generierungs-APIs als Normalisierungs-Hub. Vergleichen Sie eine Veo-Preiszeile pro Sekunde nicht direkt mit einem Anbieter auf Token-/Ressourcenpaket-Basis, ohne die tatsächliche Anforderungsstruktur zu übersetzen.
Behandeln Sie Veo-Generierung als eine lang laufende Operation
Der Veo-Leitfaden von Google zeigt einen Ablauf für lang laufende Operationen: Senden Sie die Generierungsanfrage, pollen Sie die Operation, bis sie abgeschlossen ist, und rufen Sie dann das generierte Video ab. Das macht den Veo API-Zugriff anders als eine normale Textanfrage mit nur einer Antwort. Ihr Router und Ihr Dashboard müssen den Job-Status über Polling hinweg beibehalten, nicht nur den ersten HTTP-Aufruf erfassen.
Ein produktionsreifes Protokoll sollte diese Fragen beantworten:
- Welche Anwendung, welcher Team-Schlüssel, welche Umgebung und welcher Workflow haben den Video-Job erstellt?
- Welche Veo-Modell-ID, welches Seitenverhältnis, welche Auflösung, welcher Prompt-Typ und welche Eingabemedien wurden verwendet?
- Welche Operations-ID oder welcher gleichwertige asynchrone Handle wurde zurückgegeben?
- Wie viele Polling-Versuche liefen vor Abschluss oder Fehlschlag?
- War der Job erfolgreich, fehlgeschlagen, abgebrochen, erneut versucht oder wurde er anderweitig weitergeleitet?
- Wie viele generierte Videos wurden zurückgegeben, und wo wurde die Ausgabe gespeichert?
- Welcher Nutzungsdatensatz und welcher Kostendatensatz können später von Finance abgeglichen werden?
Hier ist auch der Punkt, an dem die Endpunktkompatibilität einen echten Test braucht. Ein Gateway kann für viele Modellfamilien eine OpenAI-kompatible Base-URL bereitstellen, aber die Videoerzeugung hat oft anbieterspezifische Felder und asynchrone Semantik. Behalten Sie Codeausschnitte als Vorlagen bei, bis Sie einen aktuellen Flatkey-Schlüssel, eine aktuelle Veo-Modellzeile und den genauen Request-Body getestet haben, den Ihre Anwendung verwenden wird.
Flatkey-Katalogzeilen vor dem Produktionsbetrieb verifizieren
Der öffentliche Preis-Katalog von Flatkey wurde für diesen Artikel am 17. Juni 2026, Asia/Shanghai, geprüft. Die Antwort enthielt 638 Modellzeilen und die Preisversion a42d372ccf0b5dd13ecf71203521f9d2. Veo-bezogene Zeilen waren vorhanden, einschließlich Google-ähnlicher IDs und Aliase wie veo-3.1-generate-preview, veo-3.1-fast-generate-preview, veo-3.1-lite-generate-preview, veo3.1, veo3.1-fast und veo3.1-pro.
Der wichtige Vorbehalt: Jede in diesem Snapshot geprüfte Veo-Zeile zeigte den Verfügbarkeitsstatus unknown_failure. Das bedeutet, dass der Artikel die Zeilen als datierte Katalogbelege verwenden kann, aber nicht behaupten sollte, dass sie für den Live-Produktionsbetrieb bereit sind. Der richtige Workflow für den Veo API-Zugriff besteht darin, die aktuelle Flatkey-Preisseite zu öffnen, die genaue Zeile zu bestätigen, das Dashboard-Label zu überprüfen, die Endpoint-Familie zu prüfen und vor dem Senden von Produktionsverkehr einen kleinen Smoke-Test auszuführen.
| Geprüfte Flatkey-Zeile | Gesehene Endpoint-Typen | Gesehene Preisfelder | Status im Snapshot |
|---|---|---|---|
veo-3.1-generate-preview |
gemini, openai |
quota_type: 1, model_price: 0.4 |
unknown_failure |
veo-3.1-fast-generate-preview |
gemini, openai |
quota_type: 1, model_price: 0.15 |
unknown_failure |
veo-3.1-lite-generate-preview |
gemini, openai |
model_ratio: 37.5, completion_ratio: 1 |
unknown_failure |
veo3.1, veo3.1-fast, veo3.1-pro |
openai |
model_ratio: 37.5, completion_ratio: 1 |
unknown_failure |
Die öffentliche Produktbeschreibung von Flatkey unterstützt eine vorsichtige Routing-Story: ein API-Schlüssel, klare Preise, vereinheitlichte Abrechnung, ein Dashboard für Schlüssel, Nutzung und Routing sowie Sprache zu automatischer Umschaltung/Lastverteilung. Halten Sie den Implementierungsnachweis enger als das Marketingversprechen. Für den Veo API-Zugriff sollte der Abnahmetest ein echter, dashboard-gestützter Anfrageverlauf sein und nicht nur eine Katalogzeile.
Multi-Provider-Video-Routing-Regeln festlegen
Video-Failover ist empfindlicher als Text-Failover. Wenn ein Veo-Job fehlschlägt, kann der Wechsel zu einem anderen Anbieter Dauer, visuellen Stil, Prompt-Interpretation, Content-Filter, Ausgabeformat und Preis verändern. Ein Veo API access-Plan sollte festlegen, wann automatisches Fallback sicher ist und wann der Workflow für eine menschliche Prüfung gestoppt werden sollte.
| Situation | Empfohlene Routing-Entscheidung | Grund |
|---|---|---|
| Vorübergehender Anbieterfehler oder Timeout | Einmal erneut versuchen oder zu einer freigegebenen äquivalenten Route wechseln, wenn der Workflow dies erlaubt. | Schützt die User Experience, ohne wiederholte Fehler zu verbergen. |
| Veraltete Modell-ID | Die Route blockieren und vor Produktionsverkehr auf ein aktuelles Modell migrieren. | Verhindert eine stille Abhängigkeit von einer Route mit festem Abschaltdatum. |
| Nicht unterstützter Anfrageparameter | Closed-Fehler auslösen und die Client-Anfrage korrigieren. | Blindes Fallback wiederholt andernorts meist dieselbe fehlerhafte Anfrage. |
| Finales Rendern in hoher Auflösung | Für Fallback auf eine teurere Route eine explizite Genehmigung verlangen. | Auflösung und Dauer vervielfachen die Videokosten schnell. |
| Entwurf oder interne kreative Iteration | Niedrigere Fallback-Kosten nur zulassen, wenn Unterschiede im Output akzeptabel sind. | Entwurfs-Workflows können mehr Variation tolerieren als kundennahe Ausgaben. |
Die Zuverlässigkeitsseite dieser Entscheidung wird im AI-API-Load-Balancing-und-Failover-Playbook ausführlicher behandelt. Für Video sollten Sie jeder Fallback-Leiter Kosten- und kreative Ausgabegrenzen hinzufügen.
Führen Sie diesen Smoke-Test vor dem Start aus
Ein verantwortungsvoller Smoke-Test für den Veo API-Zugriff sollte klein, kontrolliert und leicht zu überprüfen sein:
- Erstellen oder wählen Sie einen Flatkey-Schlüssel für die Nicht-Produktionsumgebung.
- Wählen Sie eine aktuelle Veo-Zeile von der Live-Preisseite aus und notieren Sie die exakte Modellbezeichnung.
- Bestätigen Sie die Endpunktfamilie und die Request-Vorlage mit dem Produkt-/Dokumentationsverantwortlichen.
- Führen Sie einen risikofreien Video-Job mit bekannten Dauer- und Auflösungseinstellungen aus.
- Erfassen Sie die Vorgangs-ID, den Status-Abfragepfad, das Endergebnis, die abrechenbare Einheit und den Usage-Log-Eintrag.
- Wiederholen Sie den Vorgang nach Möglichkeit mit einem kontrollierten Fehler, etwa einem blockierten veralteten Modell oder einem nicht unterstützten Parameter.
- Entscheiden Sie, ob der Pfad Produktionsverkehr, nur Staging oder nur den Forschungs-Backlog bedienen kann.
Wenn eine dieser Prüfungen fehlschlägt, halten Sie den Pfad aus der Produktion heraus. Ein fehlender Usage-Log, eine unklare Preiseinheit oder ein Verfügbarkeitsstatus von unknown_failure ist bei Video kein Papierproblem; es verändert Kosten, Support und die Erwartungen der Kunden.
FAQ
Wie erhalte ich Zugriff auf die Veo API?
Beginnen Sie mit der aktuellen Gemini-API-Veo-Dokumentation und den Abrechnungsanforderungen von Google und prüfen Sie dann am Tag der Umsetzung die Modell-ID, den Endpunkt und die Preisgestaltung. Wenn Sie Flatkey für das Routing verwenden, prüfen Sie vor der Bewertung des Veo API-Zugriffs als produktionsreif den aktuellen Preiskatalog und das Dashboard.
Welche Veo-Modell-ID sollte ich verwenden?
Die aktuelle Preisübersicht für Veo 3.1 von Google führt veo-3.1-generate-preview, veo-3.1-fast-generate-preview und veo-3.1-lite-generate-preview auf. Vermeiden Sie ältere Veo-3.0- und Veo-2.0-IDs für neue produktive Arbeiten, da Google für sie die Abschaltung zum 30. Juni 2026 angibt.
Wie wird die Preisgestaltung der Veo API berechnet?
Google führt die Preise für Veo 3.1 im Paid-Tier pro Sekunde auf, mit unterschiedlichen Raten je nach Variante und Auflösung. Für den Veo API-Zugriff sollten Sie die erwarteten Sekunden, die Auflösung, die Erfolgsrichtlinie und Wiederholungen normalisieren, bevor Sie die Route mit tokenbasierten Videoanbietern oder Anbietern mit Ressourcenpaketen vergleichen.
Kann Veo mit anderen Modellen zur Videogenerierung geroutet werden?
Ja, aber erst nachdem Sie den Routing-Vertrag definiert haben. Ein Fallback von Veo auf ein anderes Videomodell kann visuelle Qualität, Dauer, Ausgabeformat, Moderationsverhalten und Kosten verändern. Verwenden Sie genehmigte Fallback-Regeln statt generischer automatischer Wiederholungen.
Was sollten Flatkey-Nutzer vor dem Produktiveinsatz prüfen?
Prüfen Sie die aktuelle Modellzeile, die Endpunktfamilie, das Dashboard-Label, den Verfügbarkeitsstatus, das Preislabel, die Felder des Nutzungsprotokolls und ein echtes Smoke-Test-Ergebnis. In dem am 17. Juni 2026 verwendeten Snapshot für diesen Artikel waren Veo-Zeilen vorhanden, zeigten jedoch unknown_failure; daher erfordert der produktive Einsatz eine frische Bestätigung.
Fazit
Veo API-Zugriff ist eine Produktionsentscheidung, nicht nur ein Häkchen beim Anbieter. Bestätigen Sie das offizielle Modell, normalisieren Sie Sekunden und Auflösung, behandeln Sie asynchrone Jobs, verifizieren Sie Flatkeys aktuelle Zeile und Dashboard-Nachweise und dokumentieren Sie Fallback-Grenzen, bevor die erste kundenorientierte Videoanfrage eingeht.
Um Veo zusammen mit dem Rest Ihres Video-Model-Stacks zu bewerten, beginnen Sie mit dem aktuellen Flatkey-Preisverzeichnis und nutzen Sie die obige Checkliste, um zu entscheiden, welche Pfade für Staging bereit sind, welche einen Smoke-Test benötigen und welche im Forschungs-Backlog bleiben sollten.
