Veo 提供基于 LLM 的提示增强工具,也称为提示重写器。提示重写器可让您选择重写提示,以便在提示中添加视频说明、镜头抖动、转写和音效。提示越详细,生成的视频质量就越高。
如果您停用提示增强功能,视频质量以及输出内容与您提供的提示的相似程度可能会受到影响。此功能在 veo-2.0-generate-001 中默认启用。
仅当原始提示的长度少于 30 个字词时,API 响应才会传送重写的提示。
如需详细了解如何编写有效的文本提示来生成视频,请参阅 Veo 提示指南。
准备工作
-
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.-
为您的环境设置身份验证。
选择标签页以了解您打算如何使用本页面上的示例:
控制台
当您使用 Cloud de Confiance 控制台访问 Cloud de Confiance by S3NS 服务和 API 时,无需设置身份验证。
REST
如需在本地开发环境中使用本页面上的 REST API 示例,请使用您提供给 gcloud CLI 的 凭证。
安装 Google Cloud CLI,然后 使用联合身份登录 gcloud CLI。
如需了解详情,请参阅 身份验证文档 中的 Cloud de Confiance 使用 REST 时进行身份验证。
关闭提示重写器
如需关闭提示增强功能,请执行以下操作:
控制台
在 Cloud de Confiance 控制台中,依次前往 Agent Platform Studio > Media Studio 页面。
点击 Veo。
在设置 中,点击启用提示增强功能切换开关 。
在撰写提示框中,输入提示,然后点击 生成。
Python
安装
pip install --upgrade google-genai
如需了解详情,请参阅 SDK 参考文档。
设置环境变量以将 Google Gen AI SDK 与 Vertex AI 搭配使用:
# 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
如需详细了解 Veo API,请参阅以下内容:
- 方法:
endpoints.predict VideoGenerationModelInstanceVideoGenerationModelParamsVideoGenerationModelResult
- 使用以下命令发送视频生成请求。此请求会启动长时间运行的操作,并将输出存储到您指定的 Cloud Storage 存储桶。
在使用任何请求数据之前,请先进行以下替换:
- PROJECT_ID:您的 Cloud de Confiance by S3NS 项目 ID。
- MODEL_ID:要使用的模型 ID。可用的值:
veo-2.0-generate-001
- TEXT_PROMPT:用于指导视频生成的文本提示。
-
OUTPUT_STORAGE_URI:可选:用于存储输出视频的 Cloud Storage 存储桶。如果未提供,则会在回答中返回视频字节。例如:
gs://video-bucket/output/。 - RESPONSE_COUNT:您要生成的视频文件数量。 接受的整数值:1-4。
- DURATION:要生成的视频文件的时长。接受介于 5 和 8 之间的整数值。
-
ENHANCED_PROMPT:是否使用增强型提示。您可以使用以下任一选项:
-
True:(默认)使用 Gemini 增强提示。 -
False:不使用 Gemini 来增强提示。
-
-
其他可选参数
根据您的应用场景,使用以下可选变量。在
"parameters": {}对象中添加以下部分或全部参数。"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:(可选)一个字符串值,用于描述所生成视频的宽高比。您可使用以下值:"16:9"表示横向"9:16"表示纵向
默认值为
"16:9" -
NEGATIVE_PROMPT:(可选)一个字符串值,用于描述您想要阻止模型生成的内容。 -
PERSON_SAFETY_SETTING:(可选)一个字符串值,用于控制生成人物或人脸的安全设置。您可使用以下值:-
"allow_adult":仅允许生成成人形象和人脸。 -
"disallow":不生成人物或人脸。
默认值为
"allow_adult"。 -
-
RESOLUTION:(可选)用于控制生成的视频分辨率的字符串值。仅受 Veo 3 模型支持。您可使用以下 值:"720p""1080p""4k"(仅限 Veo 3.1 预览版模型)
默认值为
"720p"。 -
RESPONSE_COUNT:可选。一个整数值,用于描述要生成的视频数量。可接受的值范围为1-4。 -
SEED_NUMBER:可选。一个 uint32 值,模型使用该值生成确定性视频。通过在请求中指定种子编号而无需更改其他参数,可引导模型生成相同的视频。可接受的值范围为0-4294967295。
-
HTTP 方法和网址:
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning
请求 JSON 正文:
{
"instances": [
{
"prompt": "TEXT_PROMPT"
}
],
"parameters": {
"storageUri": "OUTPUT_STORAGE_URI",
"sampleCount": "RESPONSE_COUNT",
"durationSeconds": "DURATION",
"enhancePrompt": ENHANCED_PROMPT
}
}
如需发送请求,请选择以下方式之一:
curl
将请求正文保存在名为 request.json 的文件中,然后执行以下命令:
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
将请求正文保存在名为 request.json 的文件中,然后执行以下命令:
$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"
}