Veo 3.1 Fast-API-Dokumentation
Alles, was Sie benötigen, um Veo 3.1 Fast aus Ihrem Code aufzurufen. Basis-URL: https://cheapergen.com/api/v1. Probieren Sie es zuerst in Playground aus.
Verwenden Sie einen Coding-Agenten?
Fügen Sie dies in Claude Code, Cursor, Codex oder einen beliebigen Coding-Agenten ein. Er bindet die API in Ihr Projekt ein, speichert den Schlüssel in CHEAPERGEN_API_KEY und prüft den Preis kostenlos, bevor Kosten entstehen.
Add Veo 3.1 Fast (CheaperGen endpoint google/ veo-3.1-fast/ text-to-video) to this project by following https:/ / cheapergen.com/ agents/ integrate.mdAuthentifizierung
Erstellen Sie in Dashboard → API keys einen Schlüssel und senden Sie ihn als Bearer-Token mit. Bewahren Sie Schlüssel ausschließlich auf Ihrem Server auf.
export CHEAPERGEN_API_KEY="cg_live_…"
# every request
Authorization: Bearer $CHEAPERGEN_API_KEYVeo 3.1 Fast Text zu Video-API
/api/v1/run/google/veo-3.1-fast/text-to-videoÜbermittelt einen asynchronen Auftrag und gibt 202 mit einer Generierungs-ID zurück. Fragen Sie GET /api/v1/generations/{id} ab oder übergeben Sie webhook_url. Siehe Ablauf eines Auftrags.
Eingabeparameter
| Name | Typ | Beschreibung | Beeinflusst den Preis |
|---|---|---|---|
prompterforderlich | string | Beschreiben Sie Motiv, Handlung, Kamerabewegung, Beleuchtung und Stil. | Kein |
aspect_ratio | string (enum) | Quer- oder Hochformat. Werte: 16:9 · 9:16 Standard: 16:9 | Ja |
resolution | string (enum) | Ausgabeauflösung. Clips in 1080p und 4K haben immer eine Länge von 8 Sekunden; 4K kostet mehr pro Sekunde. Werte: 720p · 1080p · 4k Standard: 720p | Ja |
duration | integer (enum) | Clip-Länge: 4, 6 oder 8 Sekunden in 720p (1080p und 4K haben immer 8 s). Abgerechnet wird pro Sekunde. Werte: 4 · 6 · 8 Standard: 8 | Ja |
generate_audio | boolean | Generieren Sie synchronisierten Ton, Atmosphäre und Dialog. Clips mit Audio werden pro Sekunde teurer abgerechnet. Standard: true | Ja |
negative_prompt | string | Dinge, die in der Ausgabe vermieden werden sollen. | Kein |
seed | integer | Verwenden Sie denselben Seed und dieselben Einstellungen, um ein Ergebnis zu reproduzieren. Leer lassen für Zufallswerte. | Kein |
webhook_url | Zeichenfolge (URL) | Optional. Wir senden die abgeschlossene Generierung per POST an diese URL und signieren die Anfrage mit Ihrem Webhook-Schlüssel. Webhooks | Kein |
Anfrage
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/veo-3.1-fast/text-to-video`, {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "Ein Gezeitentümpel bei Sonnenaufgang, eine kleine Krabbe huscht über glitzernde Felsen, Makroobjektiv, sanfte Wellen und Möwenschreie",
"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);Antwort
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "google/veo-3.1-fast",
"endpoint": "google/veo-3.1-fast/text-to-video",
"mode": "text-to-video",
"status": "queued",
"input": {
"prompt": "Ein Gezeitentümpel bei Sonnenaufgang, eine kleine Krabbe huscht über glitzernde Felsen, Makroobjektiv, sanfte Wellen und Möwenschreie",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 8
},
"output": null,
"error": null,
"cost": {
"amount_usd": 0.2255,
"currency": "usd",
"estimated": true,
"official_usd": null,
"list_price_source": "official",
"list_price_label": "Official",
"saved_usd": null
},
"source": "api",
"started_at": null,
"completed_at": null,
"urls": {
"get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
"cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
},
"created_at": "2026-10-15T09:21:04Z"
}Veo 3.1 Fast Bild zu Video-API
/api/v1/run/google/veo-3.1-fast/image-to-videoÜbermittelt einen asynchronen Auftrag und gibt 202 mit einer Generierungs-ID zurück. Fragen Sie GET /api/v1/generations/{id} ab oder übergeben Sie webhook_url. Siehe Ablauf eines Auftrags.
Eingabeparameter
| Name | Typ | Beschreibung | Beeinflusst den Preis |
|---|---|---|---|
prompterforderlich | string | Beschreiben Sie Motiv, Handlung, Kamerabewegung, Beleuchtung und Stil. | Kein |
image_urlerforderlich | string (URL) | Bild für das erste Einzelbild. JPG/PNG/WebP, URL oder Upload. | Kein |
end_image_url | string (URL) | Optionales Schlussbild – das Modell animiert den Übergang zwischen beiden. | Kein |
aspect_ratio | string (enum) | Quer- oder Hochformat. Werte: 16:9 · 9:16 Standard: 16:9 | Ja |
resolution | string (enum) | Ausgabeauflösung. Clips in 1080p und 4K haben immer eine Länge von 8 Sekunden; 4K kostet mehr pro Sekunde. Werte: 720p · 1080p · 4k Standard: 720p | Ja |
duration | integer (enum) | Clip-Länge: 4, 6 oder 8 Sekunden in 720p (1080p und 4K haben immer 8 s). Abgerechnet wird pro Sekunde. Werte: 4 · 6 · 8 Standard: 8 | Ja |
generate_audio | boolean | Generieren Sie synchronisierten Ton, Atmosphäre und Dialog. Clips mit Audio werden pro Sekunde teurer abgerechnet. Standard: true | Ja |
negative_prompt | string | Dinge, die in der Ausgabe vermieden werden sollen. | Kein |
seed | integer | Verwenden Sie denselben Seed und dieselben Einstellungen, um ein Ergebnis zu reproduzieren. Leer lassen für Zufallswerte. | Kein |
webhook_url | Zeichenfolge (URL) | Optional. Wir senden die abgeschlossene Generierung per POST an diese URL und signieren die Anfrage mit Ihrem Webhook-Schlüssel. Webhooks | Kein |
Anfrage
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/veo-3.1-fast/image-to-video`, {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "Die Kamera fährt langsam näher heran, während Dampf aus der Tasse aufsteigt und Regen am Fenster herunterläuft",
"image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
"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);Antwort
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "google/veo-3.1-fast",
"endpoint": "google/veo-3.1-fast/image-to-video",
"mode": "image-to-video",
"status": "queued",
"input": {
"prompt": "Die Kamera fährt langsam näher heran, während Dampf aus der Tasse aufsteigt und Regen am Fenster herunterläuft",
"image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 8
},
"output": null,
"error": null,
"cost": {
"amount_usd": 0.2255,
"currency": "usd",
"estimated": true,
"official_usd": null,
"list_price_source": "official",
"list_price_label": "Official",
"saved_usd": null
},
"source": "api",
"started_at": null,
"completed_at": null,
"urls": {
"get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
"cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
},
"created_at": "2026-10-15T09:21:04Z"
}Ergebnis abrufen
Generierungen laufen asynchron. Fragen Sie den Status ab, bis status den Status succeeded, failed oder canceled erreicht – oder übergeben Sie webhook_url bereits beim Absenden. Fehlgeschlagene Generierungen werden automatisch erstattet.
curl https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4 \
-H "Authorization: Bearer $CHEAPERGEN_API_KEY"Mehr: Ablauf eines Auftrags · Webhooks · Fehler
Preise für Veo 3.1 Fast
Zahlen Sie pro Videosekunde nutzungsbasiert, ohne Abo. Fehlgeschlagene Generierungen werden automatisch erstattet.
| Tarifstufe | Offizieller Preis | CheaperGen | Sie sparen |
|---|---|---|---|
720p + Audio mit nativem Audio | $0,075/s Mit einem Monatstarif: Pro $0,0717Max $0,0683 | −25% | |
720p silent | $0,0736/s | −8% | |
1080p + Audio mit nativem Audio | $0,1104/s | −8% | |
1080p silent | $0,092/s | −8% | |
4K + Audio mit nativem Audio | $0,276/s | −8% | |
4K silent | $0,23/s | −8% |
Monatstarife niedrigere Preise für die meisten Modelle (unter jedem Preis angezeigt); Sie können weiterhin nach Verbrauch zahlen. Pro $499/Monat · Max $4.999/Monat.
- Offizieller Preis: Listenpreis von Google Cloud Vertex AI für veo-3.1-fast-generate-001 (mit Audio $0.10 / $0.12 / $0.30 pro s in 720p / 1080p / 4K; nur Video $0.08 / $0.10 / $0.25). Preise geprüft am 18. Oktober 2026.
- Bei aktiviertem nativem Audio wird jede Sekunde zum Audio-Tarif abgerechnet.