Preview-Dokumentation

Integrieren Sie die Veo 4 Modell-API in Ihren Produkt-Workflow

Dieser Entwicklerleitfaden zeigt den geplanten Ablauf der Veo 4 API: Videotask erstellen, Status abfragen, Webhooks empfangen und Credits vor dem Launch planen.

API Keys öffnen Preise ansehen

Integrationsablauf

API in vier Schritten anbinden

Nutzen Sie diesen Ablauf für die Backend-Integration. Bewahren Sie den Key serverseitig auf, senden Sie Jobs asynchron und speichern Sie Ergebnis-URLs nach Abschluss.

API Key erstellen

Öffnen Sie Dashboard > API Keys und erstellen Sie einen serverseitigen Key. Browser-Clients sollten Ihr Backend aufrufen und den Key nicht offenlegen.

Videotask senden

Senden Sie eine Text-to-Video- oder Image-to-Video-Anfrage mit Prompt, Mode, Seitenverhältnis, Qualität und optionaler Webhook URL.

Fortschritt verfolgen

Fragen Sie den Task Endpoint mit task_id ab, bis succeeded oder failed erreicht ist. Webhooks reduzieren Polling in Production.

Asset speichern

Wenn der Task erfolgreich ist, speichern Sie video_url und thumbnail_url in CMS, Editor, Automatisierung oder Projektakte.

Preview-Vertrag

Geplantes REST Interface

Die Beispiele sind bewusst konkret, damit Teams Clients vorbereiten können. Bis zur Launch-Ankündigung gelten sie als Draft Contract.

Base URL

Rufen Sie die API per HTTPS vom Server aus auf. Zum Launch können versionierte Domains oder regionale Endpoints hinzukommen.

https://veo4api.net/api/video/veo4

Authentifizierung

Jede Anfrage nutzt einen Bearer Token. API Keys gehören in Server Secrets, niemals in öffentliche Frontend Bundles.

Authorization: Bearer YOUR_API_KEY

POSThttps://veo4api.net/api/video/veo4/generateKann sich ändern

Erstellt einen neuen asynchronen Veo 4 Videotask. Die Antwort gibt sofort task_id zurück, während das Rendering im Hintergrund läuft.

Feld	Typ	Pflicht	Beschreibung
`prompt`	string	Ja	Natürliche Anweisung für den Clip mit Motiv, Kamerabewegung, Stil und Grenzen.
`image_urls`	string[]	Nein	Öffentlich erreichbare Quellbilder für Image-to-Video-Jobs. Der aktuelle Proxy akzeptiert image_urls und kompatible Bild-URL-Aliase.
`aspect_ratio`	string	Nein	Geplante Werte: 16:9, 9:16 und 1:1.
`extend_task_id`	string	Nein	Optionaler task_id eines bestehenden fertigen Videos für einen Extension-Workflow.
`seeds`	number	Nein	Optionaler numerischer Seed für besser wiederholbare Ergebnisse. Aktueller Bereich: 10000 bis 99999.
`watermark`	string	Nein	Optionale Watermark-Beschriftung, die an das Video-Backend weitergegeben wird.
`enableTranslation`	boolean	Nein	Optionaler Boolean für Prompt-Übersetzung vor der Generierung. Standard ist true.
`public`	boolean	Nein	Optionaler Boolean, ob das Ergebnis in öffentlichen Showcase-Bereichen erscheinen darf.

cURL

curl -X POST "https://veo4api.net/api/video/veo4/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cinematic dolly shot of a glass greenhouse during sunrise",
    "aspect_ratio": "16:9",
    "watermark": "veo4api",
    "enableTranslation": true
  }'

JavaScript

const response = await fetch("https://veo4api.net/api/video/veo4/generate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    prompt: "Animate this product photo into a smooth studio orbit shot",
    image_urls: ["https://cdn.example.com/input/product.png"],
    aspect_ratio: "1:1",
    seeds: 12345,
    public: false
  })
});

const data = await response.json();
console.log(data.task_id);

Queued Response

{
  "task_id": "veo4_task_01j9example",
  "status": "queued",
  "model": "veo-4",
  "credits_estimated": 180,
  "created_at": "2026-05-17T08:00:00Z"
}

Completed Task Response

{
  "task_id": "veo4_task_01j9example",
  "status": "succeeded",
  "progress": 100,
  "video_url": "https://cdn.veo4api.net/results/veo4_task_01j9example.mp4",
  "thumbnail_url": "https://cdn.veo4api.net/results/veo4_task_01j9example.jpg",
  "completed_at": "2026-05-17T08:03:42Z"
}

// Poll the task with:
// GET https://veo4api.net/api/video/veo4/status?task_id={task_id}

Asynchrone Lieferung

Abschlussereignisse per Webhook empfangen

Webhook Delivery ist für den öffentlichen API Contract geplant. Bis zur Aktivierung nutzen Sie den Status Endpoint und bereiten Ihr Backend auf ein zukünftiges webhook_url Feld vor.

Signatur-Richtlinie

Webhook-Signaturen sind noch nicht final. Planen Sie die Prüfung eines künftigen Signature Headers, speichern Sie task_id und ignorieren Sie Duplikate sicher.

Beispiel Webhook Payload

{
  "event": "video.succeeded",
  "task_id": "veo4_task_01j9example",
  "status": "succeeded",
  "model": "veo-4",
  "video_url": "https://cdn.veo4api.net/results/veo4_task_01j9example.mp4",
  "credits_charged": 180,
  "created_at": "2026-05-17T08:00:00Z",
  "completed_at": "2026-05-17T08:03:42Z"
}

Zuverlässigkeit

Task States und Fehlerbehandlung

Bauen Sie Clients auf explizite Task States und retryable failures auf. Generierung ist asynchron, daher bedeutet 200 nur, dass der Task akzeptiert wurde.

State	Bedeutung
`queued`	Die Anfrage wurde akzeptiert und wartet auf Kapazität.
`processing`	Das Modell rendert oder verarbeitet das Video nach.
`succeeded`	Das Video ist bereit und Result URLs sind verfügbar.
`failed`	Generierung fehlgeschlagen. Zeigen Sie den Fehler und erlauben Sie Prompt-Anpassung oder Retry.
`canceled`	Der Task wurde vor Abschluss abgebrochen.

Code	Empfohlene Behandlung
`400`	Prüfen Sie prompt length, image_urls, aspect_ratio, seeds und public visibility vor dem Retry.
`401`	API Key fehlt, ist abgelaufen oder ungültig. Fordern Sie einen neuen Key an.
`402`	Nicht genügend Credits. Zur Billing-Seite senden oder Qualität reduzieren.
`409`	Konflikt im Task Request. Lesen Sie bei einem Plattformkonflikt den bestehenden Task statt einen neuen zu erstellen.
`429`	Rate limited. Exponential backoff verwenden und aggressives Polling vermeiden.
`500`	Temporärer Plattform- oder Modellfehler. Später erneut versuchen und Task Record behalten.

Credit-Planung

Geplante Credit-Kosten

Aktuelle Pricing Labels nutzen diese Planungszahlen für Veo 4 Kapazität. Sie sind bis zum Launch keine finalen Billing Zusagen.

Standard-Videotask

180

Geschätzte Credits pro Standard Veo 4 Videogenerierung.

HD-Videotask

240

Geschätzte Credits pro HD Veo 4 Videogenerierung.

Nur für Kapazitätsplanung verwenden. Tatsächliche API Limits, Quality Tiers und Billing können angepasst werden.