生视频接口

POST https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/veo/videos/generate

文/图生视频入参示例：

curl --location 'https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/veo/videos/generate' \
--header 'Authorization: Bearer {ak}' \
--header 'Content-Type: application/json' \
--data '{
    "instances": [
        {
            "prompt": "外星人使用魔法后，上海东方明珠塔变成了一个小玩具"
        }
    ],
    "parameters": {
        "durationSeconds": 8,
        "generateAudio": false,
        "negativePrompt": "Avoid dark and gloomy scenes.",
        "sampleCount": 2
    }
}'

完整的参数示例

{
        "instances": [{
                "prompt": string,
                "image": {
                        // Union field can be only one of the following:
                        "bytesBase64Encoded": string,
                        "gcsUri": string,
                        // End of list of possible types for union field.
                        "mimeType": string
                }
        }],
        "parameters": {
                "aspectRatio": string,
                "durationSeconds": integer,
                "enhancePrompt": boolean,
                "generateAudio": boolean,
                "negativePrompt": string,
                "personGeneration": string,
                "resolution": string, // Veo 3 models only
                "sampleCount": integer,
                "seed": uint32,
                "storageUri": string
        }
}

返回值示例

{
    "name": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/OPERATION_ID"
}

请求参数

instances中对象

属性名	类型	必需/可选	描述
prompt	string	文本转视频功能必需的参数。如果提供了输入图片提示（将图片转换为视频），则为可选。	一个文本字符串，用于引导视频的前八秒。例如： - 快速轨道镜头：在光线明亮的霓虹灯、飞行的汽车和迷雾、夜晚、光晕、体积光照的照明下，描绘了一个繁华的反乌托邦世界 - 汽车以光速全速行驶的霓虹全息图，电影般的画面，令人难以置信的细节，体积光照 - 许多斑点水母在水下脉动。它们的身体是透明的，在深海中会发光 - 极近距离拍摄的街道上浅景深的积水。反射出未来主义的东京城市，霓虹灯明亮，夜晚，有光晕 - 北极天空中舞动的北极光、闪烁的星星、白雪覆盖的景观的延时摄影 - 在美丽的落日余晖下，一个孤独的牛仔骑着马在开阔的平原上奔驰，光线柔和，色彩温暖
image	Media	可选	可选。用于指导视频生成的图片，可以是编码图片的 `bytesBase64Encoded` 字符串，也可以是 Cloud Storage 存储桶位置的 `gcsUri` 字符串 URI。以下模型支持图片转视频： - `MaaS_veo_3_generate_preview`

Medis对象


属性名	类型	描述
bytesBase64Encoded	string	图片或视频文件的字节 Base64 编码字符串。
gcsUri	string	指向 Cloud Storage 存储桶位置的字符串 URI。
mimeType	string	以下对象必需：image、video、lastFrame。指定视频或图片的 MIME 类型。对于图片：系统接受以下 MIME 类型： - image/jpeg - image/png 对于视频：系统接受以下 MIME 类型： - video/mp4

parameters对象


属性名	类型	必需/可选	描述
aspectRatio	string	可选	指定所生成视频的宽高比。可接受值为 `16:9`（默认值）或 `9:16`（不支持 `MaaS_veo_3_generate_preview`）。
durationSeconds	integer	必需	要生成的视频文件的时长： - MaaS_veo_3_generate_preview：8 秒。
enhancePrompt	boolean	可选	使用 Gemini 优化提示。可接受值为 `true` 或 `false`（默认值为 `true`）。veo3 不能禁止
generateAudio	boolean	必需（仅限 `MaaS_veo_3_generate_preview`）详见描述	MaaS_veo_3_generate_preview 的必需参数。为视频生成音频。可接受的值为 true 或 false。
negativePrompt	string	可选	一个文本字符串，用于描述您想要阻止模型生成的内容。例如： - 顶部照明、明亮的色彩 - 人物、动物 - 多辆汽车、风
personGeneration	string	可选	控制是否允许人物或人脸生成的安全设置： - allow_adult（默认值）：仅允许生成成年人 - dont_allow：禁止在图片中包含人物/人脸
resolution	string	可选	生成视频的分辨率，可接受值为 `720p`（默认值）或 `1080p`。
sampleCount	int	可选	请求的输出视频数量。接受的值为 1-4。
seed	uint32	可选	请求的数字，用于生成确定性视频（种子值）。范围为 `0-4,294,967,295`。
storageUri	string	可选	用于存储输出视频的 Cloud Storage 存储桶 URI，格式为 `gs://BUCKET_NAME/SUBDIRECTORY`。如果未提供，则返回以 Base64 编码的视频字节。

查询任务接口

POST https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/veo/videos/task

入参示例

curl --location 'https://genaiapi.cloudsway.net/v1/ai/{}endpointPath/veo/videos/task' \
--header 'Authorization: Bearer {ak}' \
--header 'Content-Type: application/json' \
--data '{
    "operationName": "projects/ku4bvh-veo/locations/us-central1/publishers/google/models/veo-3.0-generate-001/operations/54fefa07-3efa-40dc-92c6-427390c91689"
}'

{
  "operationName": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/OPERATION_ID"
}

返回值示例

{   "name": string,   "done": boolean,   "response":{      "@type":"type.googleapis.com/cloud.ai.large_models.vision.GenerateVideoResponse",      "raiMediaFilteredCount": integer,      "videos":[         {           "gcsUri": string,           "mimeType": string         },         {           "gcsUri": string,           "mimeType": string         },         {           "gcsUri": string,           "mimeType": string         },         {           "gcsUri": string,           "mimeType": string         },      ]   }}