Veo Video-Generierung
Generiere KI-Videos über die AceDataCloud-Google-Veo-API.
Einrichtung: Siehe Authentifizierung für die Token-Einrichtung.
Schnellstart
curl -X POST https://api.acedata.cloud/veo/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"action": "text2video", "prompt": "a whale breaching in slow motion at golden hour", "model": "veo3", "callback_url": "https://api.acedata.cloud/health"}'
Asynchron: Siehe asynchrones Task-Polling. Frage über
POST /veo/tasksmit{"id": "..."}ab. Dies gibt sofort eine Task-ID zurück. Frage das Ergebnis ab:
curl -X POST https://api.acedata.cloud/veo/tasks \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"id": "<task_id from above>"}'
Modelle
| Modell | Audio | Am besten geeignet für |
|---|---|---|
veo2 | Nein | Kosten-effektive Generierung |
veo2-fast | Nein | Schnelle, kosten-effektive Generierung (Standard) |
veo3 | Ja (nativ) | Vollständige audiovisuelle Generierung |
veo3-fast | Ja (nativ) | Schnellere audiovisuelle Generierung |
veo31 | Ja (nativ) | Veo 3.1, höchste Qualität |
veo31-fast | Ja (nativ) | Veo 3.1 schnelle Variante |
veo31-fast-ingredients | Ja (nativ) | Veo 3.1 schnell, Zutaten-Modus |
Workflows
1. Text-zu-Video
POST /veo/videos
{
"action": "text2video",
"prompt": "cinematic aerial shot of the Northern Lights over Iceland",
"model": "veo3",
"resolution": "1080p"
}
2. Bild-zu-Video
Animieren von Standbildern in Videos.
POST /veo/videos
{
"action": "image2video",
"prompt": "the scene gently comes to life with wind and subtle motion",
"image_urls": ["https://example.com/landscape.jpg"],
"model": "veo2",
"aspect_ratio": "16:9"
}
3. Zutaten-zu-Video (Mehrbild-Blending)
Mische 1–3 Referenzbilder zu einem Video (nur veo31-fast-ingredients).
POST /veo/videos
{
"action": "ingredients2video",
"image_urls": [
"https://example.com/img1.jpg",
"https://example.com/img2.jpg"
],
"model": "veo31-fast-ingredients"
}
4. Hochskalieren auf 1080p
Konvertiere ein zuvor generiertes Video in die volle 1080p-Auflösung.
POST /veo/videos
{
"action": "get1080p",
"video_id": "your-video-id",
"model": "veo3"
}
Parameter
| Parameter | Werte | Beschreibung |
|---|---|---|
action | "text2video", "image2video", "ingredients2video", "get1080p" | Generierungsmodus |
model | siehe Modelle-Tabelle | Zu verwendendes Modell (Standard: veo2-fast) |
resolution | "4k", "1080p", "gif" | Ausgabeauflösung (Standard: 720p) |
aspect_ratio | "16:9", "9:16", "1:1", "4:3", "3:4" | Seitenverhältnis – nur gültig für image2video |
image_urls | Array von Zeichenketten | Referenzbild-URLs – für image2video (bis zu 2) oder ingredients2video (bis zu 3) |
video_id | Zeichenkette | Hochzuskalierendes Video – nur für get1080p |
translation | true / false | Prompt automatisch ins Englische übersetzen (Standard: false) |
Endpunkte nach der Generierung
Nachdem ein Video generiert wurde, können diese Endpunkte zur weiteren Verarbeitung verwendet werden:
Hochsample (POST /veo/upsample)
Skaliere ein generiertes Video auf 1080p, 4K hoch oder konvertiere es in GIF.
POST /veo/upsample
{
"video_id": "your-video-id",
"action": "4k"
}
| Parameter | Werte | Beschreibung |
|---|---|---|
video_id | Zeichenkette | Task-ID von /veo/videos, /veo/extend, /veo/reshoot oder /veo/objects |
action | "1080p", "4k", "gif" | Hochsample-Ziel |
Verlängern (POST /veo/extend)
Ein bestehendes Video fortsetzen – die KI generiert automatisch das nächste Segment.
POST /veo/extend
{
"video_id": "your-video-id",
"model": "veo31-fast",
"prompt": "the camera slowly zooms out"
}
| Parameter | Werte | Beschreibung |
|---|---|---|
video_id | Zeichenkette | Task-ID von /veo/videos oder einem vorherigen /veo/extend |
model | "veo31-fast", "veo31" | Nur Veo 3.1 Serie wird unterstützt |
prompt | Zeichenkette | Optional: leitet das verlängerte Segment |
Neudrehen (POST /veo/reshoot)
Ein Video neu rendern, wobei der gleiche Inhalt erhalten bleibt, aber eine neue Kamerabewegung angewendet wird.
POST /veo/reshoot
{
"video_id": "your-video-id",
"motion_type": "LEFT_TO_RIGHT"
}
| Parameter | Werte | Beschreibung |
|---|---|---|
video_id | Zeichenkette | Task-ID von /veo/videos (keine Ausgabe von /veo/extend erlaubt) |
motion_type | siehe Tabelle unten | Anzuwendende Kamerabewegung |
motion_type-Werte:
STATIONARY, STATIONARY_UP, STATIONARY_DOWN, STATIONARY_LEFT, STATIONARY_RIGHT, STATIONARY_DOLLY_IN_ZOOM_OUT, STATIONARY_DOLLY_OUT_ZOOM_IN, UP, DOWN, LEFT_TO_RIGHT, RIGHT_TO_LEFT, FORWARD, BACKWARD, DOLLY_IN_ZOOM_OUT, DOLLY_OUT_ZOOM_IN
Objekte (POST /veo/objects)
Objekte in einem Video mittels maskenbasierter Inpainting einfügen oder entfernen.
POST /veo/objects
{
"video_id": "your-video-id",
"action": "insert",
"prompt": "add a flying bird"
}
POST /veo/objects
{
"video_id": "your-video-id",
"action": "remove",
"image_mask": "https://example.com/mask.jpg"
}
| Parameter | Werte | Beschreibung |
|---|---|---|
video_id | Zeichenkette | Task-ID (keine Ausgabe von /veo/extend erlaubt) |
action | "insert", "remove" | Operationstyp |
prompt | Zeichenkette | Erforderlich für insert; optional für remove |
image_mask | Zeichenkette | URL oder base64-JPEG – weiße Pixel = Zielregion. Erforderlich für remove; optional für insert |
Fallstricke
- Veo 3 und 3.1 Modelle generieren nativen Audio –
veo2/veo2-fastunterstützen KEINEN Audio - Die Aktion
get1080pverwendetvideo_id(von einer vorherigen Generierung), keine URL aspect_ratioist nur gültig für die Aktionimage2videoimage_urlsakzeptiert ein Array – bis zu 2 Bilder fürimage2video, bis zu 3 füringredients2videoveo31-fast-ingredientserfordert Bildeingabe – es kann keine reine Textgenerierung durchführentranslation: trueübersetzt chinesische oder andere nicht-englische Prompts automatisch vor dem Senden an Veo- Task-Polling verwendet
id(nichttask_id) im Request-Body von/veo/tasks - Task-Zustände verwenden
"succeeded"(nicht „completed“) – überprüfe beim Polling auf diesen Wert - Die Ausgabe von
/veo/extendkann nicht als Eingabe für/veo/reshootoder/veo/objectsverwendet werden
MCP:
pip install mcp-veo| Gehostet:https://veo.mcp.acedata.cloud/mcp| Siehe alle MCP-Server