Sie können Veo auf der Gemini Enterprise Agent Platform verwenden, um Videos auf eine Länge zwischen 1 und 30 Sekunden zu verlängern. Das ist entweder über die Cloud de Confiance Console oder die Agent Platform API möglich.
Die folgenden Modelle unterstützen das Verlängern von Videos:
-
veo-2.0-generate-exp -
veo-2.0-generate-preview -
veo-3.1-generate-preview -
veo-3.1-fast-generate-preview -
veo-3.1-generate-001 -
veo-3.1-fast-generate-001 -
veo-3.1-lite-generate-001
Informationen zum Schreiben effektiver Text-Prompts für die Videogenerierung finden Sie im Veo-Prompt-Leitfaden.
Hinweis
-
In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
Enable the Agent Platform API.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enablepermission. Learn how to grant roles.-
Richten Sie die Authentifizierung für Ihre Umgebung ein.
Wählen Sie den Tab für die Art und Weise aus, wie Sie die Beispiele auf dieser Seite verwenden möchten:
Console
Wenn Sie über die Cloud de Confiance Console auf Cloud de Confiance by S3NS Dienste und APIs zugreifen, müssen Sie die Authentifizierung nicht einrichten.
REST
Wenn Sie die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, verwenden Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.
Installieren Sie die Google Cloud CLI und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an.
Weitere Informationen finden Sie in der Dokumentation zur Cloud de Confiance -Authentifizierung unter Für die Verwendung von REST authentifizieren.
Beschränkungen
Bei der Verwendung von Veo Extend unterliegen Eingabevideos den folgenden Einschränkungen:
- Die Eingabedatei muss im MP4-Format vorliegen.
- Die Länge muss zwischen 1 und 30 Sekunden liegen.
- Die Framerate muss 24 Bilder pro Sekunde betragen.
- Die Auflösung muss 720p, 1080p oder 4K sein.
- Das Seitenverhältnis für Eingabevideos kann entweder 9:16 oder 16:9 sein.
Ausgabevideos unterliegen den folgenden Einschränkungen:
- Die Ausgabedatei ist eine MP4-Datei.
- Die zusätzliche Länge beträgt 7 Sekunden.
- Die Framerate beträgt 24 Bilder pro Sekunde.
- Die Auflösung kann 720p, 1080p oder 4K betragen.
- Das Seitenverhältnis für Ausgabevideos kann entweder 9:16 oder 16:9 sein.
Video verlängern
Die folgenden Beispiele zeigen, wie Sie ein Veo-Video verlängern können:
Console
Rufen Sie in der Cloud de Confiance Console die Seite Agent Platform > Media Studio auf.
Klicken Sie auf Video.
Wählen Sie im Menü Aufgabe die Option Videoerweiterung aus.
Wählen Sie im Menü Modell ein Modell aus den angezeigten Optionen aus.
Klicken Sie im Abschnitt Eingabevideo auf Hinzufügen.
Geben Sie im Feld Prompt einen Text-Prompt ein, der die zu generierenden Videos beschreibt.
Optional: Passen Sie die folgenden Parameter an:
Anzahl der Ergebnisse: Sie können den Schieberegler anpassen oder einen Wert zwischen 1 und 4 eingeben.
Videolänge: Wähle im Menü eine Videolänge aus.
Ausgabeordner: Klicken Sie auf Durchsuchen, um einen Cloud Storage-Bucket zum Speichern der generierten Dateien zu erstellen oder auszuwählen.
Klicken Sie auf Ausführen.
Python
Installieren
pip install --upgrade google-genai
Weitere Informationen finden Sie in der SDK-Referenzdokumentation.
Umgebungsvariablen für die Verwendung des Google Gen AI SDK mit Vertex AI festlegen:
# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values # with appropriate values for your project. export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT export GOOGLE_CLOUD_LOCATION=global export GOOGLE_GENAI_USE_ENTERPRISE=True
REST
Weitere Informationen zur Veo API finden Sie hier:
- Methode:
endpoints.predict VideoGenerationModelInstanceVideoGenerationModelParamsVideoGenerationModelResult
Verwenden Sie den folgenden Befehl, um eine Anfrage zur Videogenerierung zu senden. Mit dieser Anfrage wird ein Vorgang mit langer Ausführungszeit gestartet und die Ausgabe in einem von Ihnen angegebenen Cloud Storage-Bucket gespeichert.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
-
PROJECT_ID: Ein String, der Ihre Cloud de Confiance by S3NS Projekt-ID darstellt. -
MODEL_ID: Ein String, der die zu verwendende Modell-ID darstellt. Verwenden Sie eine der folgenden Optionen, wenn Sie den ersten oder letzten Videoframes angeben:- Veo 2:
veo-2.0-generate-001 - Veo 3:
veo-3.1-generate-001 - Veo 3:
veo-3.1-fast-generate-001
- Veo 2:
-
TEXT_PROMPT: Der Text-Prompt, der zur Steuerung der Videogenerierung verwendet wird. -
PATH_TO_VIDEO: Ein String, der den Cloud Storage-Pfad zum Veo-Video darstellt, das Sie erweitern. Beispiel:"gs://video-bucket/input/veo-video.mp4". -
OUTPUT_STORAGE_URI: Optional: Ein String, der den Cloud Storage-Bucket darstellt, in dem die Ausgabevideos gespeichert werden sollen. Wenn nicht angegeben, werden Videobyte in der Antwort zurückgegeben. Beispiel:"gs://video-bucket/output/". -
RESPONSE_COUNT: Die Anzahl der zu generierenden Videodateien. Der zulässige Wertebereich ist1–4. -
Zusätzliche optionale Parameter
Verwenden Sie je nach Anwendungsfall die folgenden optionalen Variablen. Fügen Sie dem
"parameters": {}-Objekt einige oder alle der folgenden Parameter hinzu."parameters": { "aspectRatio": "ASPECT_RATIO", "negativePrompt": "NEGATIVE_PROMPT", "personGeneration": "PERSON_SAFETY_SETTING", // "resolution": RESOLUTION, // Veo 3 models only "sampleCount": RESPONSE_COUNT, "seed": SEED_NUMBER }-
ASPECT_RATIO: Optional: Ein Stringwert, der das Seitenverhältnis der generierten Videos beschreibt. Sie können die folgenden Werte verwenden:"16:9"für Landschaft"9:16"für Hochformat
Der Standardwert ist
"16:9". -
NEGATIVE_PROMPT(optional): Ein Stringwert, der Inhalte beschreibt, die das Modell nicht generieren soll. -
PERSON_SAFETY_SETTING: Optional: Ein Stringwert, der die Sicherheitseinstellung für die Generierung von Personen oder Gesichtern steuert. Sie können die folgenden Werte verwenden:-
"allow_adult": Nur Generierung von Erwachsenen und Gesichtern zulassen. -
"disallow": Es werden keine Personen oder Gesichter generiert.
Der Standardwert ist
"allow_adult". -
-
RESOLUTION: Optional: Ein Stringwert, der die Auflösung des generierten Videos steuert. Wird nur von Veo 3-Modellen unterstützt. Sie können die folgenden Werte verwenden:"720p""1080p""4k"(nur Veo 3.1-Vorabversionen)
Der Standardwert ist
"720p". -
RESPONSE_COUNT: Optional. Ein Ganzzahlwert, der die Anzahl der zu generierenden Videos angibt. Der zulässige Wertebereich ist1–4. -
SEED_NUMBER: Optional. Ein uint32-Wert, den das Modell zum Generieren deterministischer Videos verwendet. Wenn Sie eine Quell-Nummer in Ihrer Anfrage angeben, ohne andere Parameter zu ändern, wird das Modell angewiesen, dieselben Videos zu erstellen. Der zulässige Wertebereich ist0–4294967295.
-
HTTP-Methode und URL:
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning
JSON-Text der Anfrage:
{ "instances": [ { "prompt": "TEXT_PROMPT", "video": { "gcsUri": "PATH_TO_VIDEO", "mimeType": "video/mp4" } } ], "parameters": { "storageUri": "OUTPUT_STORAGE_URI", "sampleCount": RESPONSE_COUNT } }Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
Diese Anfrage gibt einen vollständigen Vorgangsnamen mit einer eindeutigen Vorgangs-ID zurück. Verwenden Sie diesen vollständigen Vorgangsnamen, um den Status der Videogenerierungsanfrage abzurufen.curl
Speichern Sie den Anfragetext in einer Datei mit dem Namen
request.jsonund führen Sie den folgenden Befehl aus:curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning"PowerShell
Speichern Sie den Anfragetext in einer Datei mit dem Namen
request.jsonund führen Sie den folgenden Befehl aus:$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning" | Select-Object -Expand Content{ "name": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/a1b07c8e-7b5a-4aba-bb34-3e1ccb8afcc8" }-
Optional: Prüfen Sie den Status des Vorgangs mit langer Ausführungszeit für die Videogenerierung.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID: Ihre Cloud de Confiance by S3NS Projekt-ID.
- MODEL_ID: Die zu verwendende Modell-ID.
- OPERATION_ID: Die eindeutige Vorgangs-ID, die in der ursprünglichen Anfrage zum Generieren von Videos zurückgegeben wurde.
HTTP-Methode und URL:
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:fetchPredictOperation
JSON-Text der Anfrage:
{ "operationName": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/OPERATION_ID" }Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
Diese Anfrage gibt Informationen zum Vorgang zurück, einschließlich der Frage, ob der Vorgang noch ausgeführt wird oder abgeschlossen ist.curl
Speichern Sie den Anfragetext in einer Datei mit dem Namen
request.jsonund führen Sie den folgenden Befehl aus:curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:fetchPredictOperation"PowerShell
Speichern Sie den Anfragetext in einer Datei mit dem Namen
request.jsonund führen Sie den folgenden Befehl aus:$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:fetchPredictOperation" | Select-Object -Expand Content
Nächste Schritte
Leitfaden für Prompts für Veo auf der Gemini Enterprise Agent Platform
Best Practices für Veo auf der Gemini Enterprise Agent Platform
Videos mit Veo auf der Gemini Enterprise Agent Platform aus Text-Prompts generieren
Videos mit Veo auf der Gemini Enterprise Agent Platform aus einem Bild generieren