Veo 3.1 API-Dokumentation
Vollständiger Leitfaden zur Integration der KI-Videogenerierung von Google in Ihre Anwendungen.
Schnellstart-Anleitung
Starten Sie mit der Veo 3.1 API in nur wenigen Minuten.
API-Schlüssel erhalten
Zuerst müssen Sie einen API-Schlüssel im Dashboard erhalten.
Erste Anfrage senden
Generierungsstatus prüfen
Die Videogenerierung erfolgt asynchron. Verwenden Sie den https://veo3api.com/feed Endpoint zur Statusabfrage oder geben Sie eine
API-Referenz
Vollständige Referenz aller Veo-3.1-API-Endpunkte, Parameter und Antwortformate.
Basis-URL
https://veo3api.comEndpunkte verwenden kein /api-Präfix — rufen Sie https://veo3api.com/ auf (z. B. https://veo3api.com/generate).
Authentifizierung
Alle API-Anfragen erfordern eine Authentifizierung mit einem Bearer-Token im Authorization-Header.
Authorization: Bearer YOUR_API_KEYhttps://veo3api.com/generateVideo aus Text- oder Bild-Prompt generieren
Request-Body
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
prompt | string | * | Text-Prompt für die Videogenerierung |
model | string | * | Wahl zwischen veo3 (hohe Qualität, 180 Credits) oder veo3-fast (schnelle Generierung, 25 Credits) |
aspect_ratio | string | Seitenverhältnis: 16:9 (Standard, 1080P HD), 9:16 (Hochformat) oder Auto (wie Bild) | |
image_urls | string[] | Array von Bild-URLs für die Bild-zu-Video-Generierung | |
watermark | string | Benutzerdefinierter Wasserzeichentext. Auf null setzen, um kein Wasserzeichen zu verwenden |
Beispielanfrage
Antwort
Credit-Verbrauch
| Modelltyp | Credits | Kosten |
|---|---|---|
veo3-fast | 25 credits | $0.25 |
veo3 | 180 credits | $1.80 |
extend | Wie Original | - |
get-1080p | Kostenlos | $0.00 |
Hinweis: Credits werden nur bei erfolgreichem Abschluss der Videogenerierung abgezogen. Fehlgeschlagene Aufgaben verbrauchen keine Credits.
https://veo3api.com/feedStatus einer Videogenerierungsaufgabe prüfen
Beispielanfrage
GET https://veo3api.com/feed?task_id=YOUR_TASK_IDAntwort
💡 Tipp: Die URL des generierten Videos finden Sie im Array data.response.
https://veo3api.com/extendEin bestehendes Video mit einem neuen Prompt erweitern. Das erweiterte Video setzt am Ende des Originalvideos fort.
Request-Body
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
task_id | string | * | task_id des ursprünglichen abgeschlossenen Videos zur Erweiterung |
prompt | string | * | Text-Prompt, der beschreibt, wie das Video fortgesetzt werden soll |
seeds | integer | Zufalls-Seed (10000–99999) für reproduzierbare Generierung. Derselbe Seed erzeugt ähnliche Ergebnisse | |
watermark | string | Benutzerdefinierter Wasserzeichentext. Auf null setzen, um kein Wasserzeichen zu verwenden |
Beispielanfrage
Antwort
Hinweis: Nur abgeschlossene Videotasks können erweitert werden. In 1080P konvertierte Videos können nicht erweitert werden.
https://veo3api.com/get-1080pKostenlosDie hochauflösende 1080P-Version einer abgeschlossenen Aufgabe abrufen. Dieser Endpunkt ist kostenlos und verbraucht keine Credits.
Beispielanfrage
GET https://veo3api.com/get-1080p?task_id=YOUR_TASK_IDAntwort
💡 Tipp: Dieser Endpunkt ist vollständig kostenlos. Sie können die 1080P-Version jedes abgeschlossenen Videos ohne Credit-Verbrauch abrufen.
HTTP-Statuscodes
| Statuscode | Beschreibung |
|---|---|
200 | Anfrage erfolgreich |
400 | Ungültige Anfrage — fehlerhafte Parameter |
401 | Nicht autorisiert — ungültiger API-Schlüssel |
429 | Rate-Limit überschritten |
500 | Interner Serverfehler |