Vira2
# Vira_V2 公开API目录
# API概览
Vira产品提供以下相关API接口。
| API | 描述 |
|---|---|
| GetPresignedUrl | 获取临时上传URL |
| FinishUpload | 完成图片上传 |
| CreateImg2video | 创建图生视频 |
| CreateReference2video | 创建参考生视频 |
| CreateStartEnd2video | 创建首尾帧 |
| CreateText2video | 创建文生视频 |
| CreateTemplate2video | 创建场景模板 |
| CreateUpscale | 创建智能超清 |
| QueryTask | 查询任务状态 |
# 实例相关
# 1.GetPresignedUrl
Action： GetPresignedUrl
描述： 获取临时上传链接, 有效期1小时
请求地址： api.capitalonline.net/platform/vira_v2
请求方法： GET
请求参数：
无
请求示例：
def get_presigned_url():
action = "GetPresignedUrl"
method = "GET"
param = {}
url = get_signature(action, ak, sk, method, VIRA_URL, param)
resp = requests.get(url)
result = json.loads(resp.content)
return result
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
| 名称 | 类型 | 示例值 | 描述 | |
|---|---|---|---|---|
| PutUrl | string | https://uploads.vira.zone/tmp/viraxxxxxxxx | 临时上传URL | |
| ResourceId | string | 8c5b193a-610e-42ec-b3d7-d750xxxxxxxx | 资源ID |
返回示例：
{
"Code": "Success",
"Msg": "success",
"Data": {
"PutUrl": "https://uploads.vira.zone/tmp/vira/2474806830488541/24/1114/052204-sR72Xhrhll3rUPcJ?Expires=1731565324&Signature=Zag7IAkDXNYSD4BcMB7Tk5UpnZmtS6RjRcXJKGbwIvLTpOH5Aw5KHUe~2iC0h2NLCfh5O3eMbARQQe~GgpgMfI~ApQBVJIMAzyDfMnE8AWC-s8-330M9T9Ld3sPNlOPWGr1W6HLKWAI52nT7yrc0Q4wawwAk2l3NtNEMbUBlGffqgX1yZgBCbEpeqMlR~BgSVXDGH-N4imU95myVhLo8Teez8XpGrWwTbKdtPfi8CWzZ0S3Dhi9uSnGflPK1kY2pkd47JvZ45-zg~hmdUPB9sLIqBzUCDklwnBWVvW9wfOZyaC8fhVPfACV0dnPy9Hg0~foFuQB5AwTJFyOP9cJ-mA__&Key-Pair-Id=K3DNVHKWMZJUYO",
"ResourceId": "2518629169423677"
},
"RequestId": "9f34a3ae-5314-47c3-be4a-98f59d34f379"
}
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
# 2.上传图片
Action： 无
描述： 根据临时上传地址，上传图片;关键参数：临时上传地址，文件目录
请求地址： GetPresignedUrl接口返回的PutUrl
请求方法： PUT
请求参数：
请求示例：
def up_load(self, up_load_url, file_path):
headers = {'Content-Type': 'image/jpeg'}
with open(file_path, 'rb') as file:
resp = requests.put(up_load_url, data=file, headers=headers)
etag = resp.headers.get('ETag')[1:-1]
print(resp.headers)
return etag
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
返回参数说明： 无
返回示例：
return headers: e89d5e7471697f93312b37ed363c7c1a
return headers:
{
'Content-Length': '0',
'Connection': 'keep-alive',
'Date': 'Thu, 14 Nov 2024 05:27:06 GMT',
'x-amz-expiration': 'expiry-date="Fri, 22 Nov 2024 00:00:00 GMT", rule-id="delete-for-7-days"',
'x-amz-server-side-encryption': 'AES256',
'ETag': '"e89d5e7471697f93312b37ed363c7c1a"',
'Server': 'AmazonS3',
'X-Cache': 'Miss from cloudfront',
'Via': '1.1 af20b510de9d2ffdf592bdca91fc8b42.cloudfront.net (CloudFront)',
'X-Amz-Cf-Pop': 'SZX51-E1',
'X-Amz-Cf-Id': '_DszqP264fDyrKzkU8thgzaQMQ48bQV4rvQ4R55kcamxz73IHvIqHg==',
'Vary': 'Origin'
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 3.FinishUpload
Action： FinishUpload
描述： 确认完成上传
请求地址： api.capitalonline.net/platform/vira_v2
请求方法： POST
请求参数：
| 参数名 | 必选 | 类型 | 说明 | |
|---|---|---|---|---|
| ResourceId | 是 | string | 资源ID | |
| Etag | 是 | string | 文件Etag |
请求示例：
def finish(etag, resource_id):
action = "FinishUpload"
method = "POST"
param = {}
body = {
"ResourceId": resource_id,
"Etag": etag
}
print(body)
url = get_signature(action, ak, sk, method, VIRA_URL, param)
resp = requests.post(url, json=body)
result = json.loads(resp.content)
print(result)
return result**返回参数说明：**
1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
| 参数名 | 必选 | 类型 | 说明 | |
|---|---|---|---|---|
| Url | string | 图像在线链接 |
返回示例：
{
"Code": "Success",
"Msg": "success",
"Data": {
"Url": "ssupload:?id=2518629169423678"
},
"RequestId": "40dfb74f-8497-4937-a663-f9b428638803"
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
# 4.CreateImg2video
Action： CreateImg2video
描述： 创建图生视频
请求地址： api.capitalonline.net/platform/vira_v2
请求方法： POST
请求参数：
| 参数名 | 类型 | 必选 | 说明 |
|---|---|---|---|
| Model | String | 是 | 模型名称 可选值：vidu2.0、vidu1.5、vidu1.0 |
| Images | Array[String] | 是 | 首帧图像 模型将以此参数中传入的图片为首帧画面来生成视频。 注1：只支持输入 1 张图； 注2：图片支持 png、jpeg、.jpg、webp格式； 注3：图片比例需要小于 1:4 或者 4:1 ； 注4：图片大小不超过 10 MB； |
| Prompt | String | 可选 | 文本提示词 生成视频的文本描述。 注：字符长度不能超过 1500 个字符 |
| Duration | Int | 可选 | 视频时长 默认 4，可选值：4、8 |
| Seed | Int | 可选 | 随机种子 当默认不传或者传0时，会使用随机数替代 手动设置则使用设置的种子 |
| Resolution | String | 可选 | 分辨率 默认 360p，可选值如下： vidu1.0 仅可使用360p vidu1.5 和 vidu2.0 4秒的视频可使用360p、720p、1080p等清晰度 vidu1.5 和 vidu2.0 8秒的视频仅支持720p清晰度 |
| MovementAmplitude | String | 可选 | 运动幅度 供 vidu1.5 和 vidu2.0模型可用 默认 auto，可选值：auto、small、medium、large 高动态性是 vidu 模型的特色之一，为了更好的服务不同的需求，我们开放了控制视频动态幅度的参数 |
请求示例：
def create_img2video(self):
action = "CreateImg2video"
method = "POST"
headers = {'Content-Type': 'image/jpeg'}
param = {}
body = {
"Model": "vidu2.0",
"Images": ["https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png"],
"Prompt": "The astronaut waved and the camera moved up.",
"Duration": "4",
"Seed": "0",
"Resolution": "720p",
"MovementAmplitude": "auto"
}
url = get_signature(action, self.ak, self.sk, method, self.url, param)
print("开始图生视频, url is", url)
resp = requests.post(url, json=body)
result = json.loads(resp.content)
print(result)
return result
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
返回参数说明：
| 参数名 | 类型 | 说明 |
|---|---|---|
| TaskId | String | Vidu 生成的任务ID |
| State | String | 处理状态 可选值： created 创建成功 queueing 任务排队中 processing 任务处理中 success 任务成功 failed 任务失败 |
| Model | String | 本次调用的模型名称 |
| Prompt | String | 本次调用的提示词参数 |
| Images | Array[String] | 本次调用的图像参数 |
| Duration | Int | 本次调用的视频时长参数 |
| Seed | Int | 本次调用的随机种子参数 |
| Resolution | String | 本次调用的分辨率参数 |
| MovementAmplitude | String | 本次调用的镜头动态幅度参数 |
| CreatedAt | String | 任务创建时间 |
返回示例：
{
"Code": "Success",
"Msg": "success",
"Data": {
"TaskId": "802733419330027520",
"Type": "img2video",
"State": "created",
"Model": "vidu2.0",
"Style": "general",
"Prompt": "The astronaut waved and the camera moved up.",
"Images": [
"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png"
],
"Duration": 4,
"Seed": 235027989,
"AspectRatio": "16:9",
"Resolution": "720p",
"MovementAmplitude": "auto",
"CreatedAt": "2025-03-27T06:47:56.361708182Z"
},
"RequestId": "B5AC9B2B-1B5B-43A8-9E2C-9C37DF859C2A"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
# 5.CreateReference2video
Action： CreateReference2video
描述： 创建参考生视频
请求地址： api.capitalonline.net/platform/vira_v2
请求方法： POST
请求参数：
| 参数名 | 类型 | 必选 | 说明 |
|---|---|---|---|
| Model | String | 是 | 模型名称 可选值：vidu2.0、vidu1.5、vidu1.0 |
| Images | Array[String] | 是 | 图像参考 支持输入 1～3 张图片（vidu1.0 仅支持输入1张图片，vidu1.5和 vidu2.0支持输入1～3 张图），模型将以此参数中传入的图片中的主题为参考生成具备主体一致的视频。 注1：图片支持 png、jpeg、.jpg、webp格式 注2：图片像素不能小于 128*128，且比例需要小于1:4或者4:1 注3: 且大小不超过10M。 注：vidu1.0模型下，仅支持传入一张图片 |
| Prompt | String | 是 | 文本提示词 生成视频的文本描述。 注：字符长度不能超过 1500 个字符 |
| Duration | Int | 可选 | 视频时长 默认 4，可选值：4、8 vidu 2.0 仅支持输入 4 |
| Seed | Int | 可选 | 随机种子 当默认不传或者传0时，会使用随机数替代 手动设置则使用设置的种子 |
| AspectRatio | String | 可选 | 比例 默认 16:9，可选值如下： vidu1.0 可选值：16:9 vidu 1.5和 vidu2.0 可选值：16:9、9:16、1:1 |
| Resolution | String | 可选 | 分辨率 默认 360p，可选值如下： vidu1.0 仅可使用360p vidu1.5 4 秒的视频可使用360p、720p、1080p，8 秒的视频可使用720p vidu 2.0 4 秒的视频可使用360p、720p |
| MovementAmplitude | String | 可选 | 运动幅度 供 vidu1.5 和 vidu2.0模型可用 默认 auto，可选值：auto、small、medium、large 高动态性是 vidu 模型的特色之一，为了更好的服务不同的需求，我们开放了控制视频动态幅度的参数 |
请求示例：
def create_reference2video(self):
action = "CreateReference2video"
method = "POST"
param = {}
body = {
"Model": "vidu2.0",
"Images": ["https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-1.png","https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-2.png","https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-3.png"],
"Prompt": "Santa Claus and the bear hug by the lakeside.",
"Duration": "4",
"Seed": "0",
"AspectRatio": "16:9",
"Resolution": "720p",
"MovementAmplitude": "auto"
}
url = get_signature(action, self.ak, self.sk, method, self.url, param)
print("开始参考生视频, url is", url)
resp = requests.post(url, json=body)
result = json.loads(resp.content)
print(result)
return result
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
返回参数说明：
| 参数名 | 类型 | 说明 |
|---|---|---|
| TaskId | String | Vidu 生成的任务ID |
| State | String | 处理状态 可选值： created 创建成功 queueing 任务排队中 processing 任务处理中 success 任务成功 failed 任务失败 |
| Model | String | 本次调用的模型名称 |
| Prompt | String | 本次调用的提示词参数 |
| Images | Array[String] | 本次调用的图像参数 |
| Duration | Int | 本次调用的视频时长参数 |
| Seed | Int | 本次调用的随机种子参数 |
| AspectRatio | String | 本次调用的 比例 参数 |
| Resolution | String | 本次调用的分辨率参数 |
| MovementAmplitude | String | 本次调用的镜头动态幅度参数 |
| CreatedAt | String | 任务创建时间 |
返回示例：
{
"Code": "Success",
"Msg": "success",
"Data": {
"TaskId": "802734181317623808",
"Type": "character2video",
"State": "created",
"Model": "vidu2.0",
"Style": "general",
"Prompt": "Santa Claus and the bear hug by the lakeside.",
"Images": [
"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-1.png",
"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-2.png",
"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-3.png"
],
"Duration": 4,
"Seed": 1935859102,
"AspectRatio": "16:9",
"Resolution": "720p",
"MovementAmplitude": "auto",
"CreatedAt": "2025-03-27T06:50:58.033456184Z"
},
"RequestId": "5D4DBBC6-2AE3-4D7B-A198-EF30E2ABD0C3"
}d
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# 6.CreateStartEnd2video
Action： CreateStartEnd2video
描述： 创建首尾帧
请求地址： api.capitalonline.net/platform/vira_v2
请求方法： POST
请求参数：
| 参数名称 | 类型 | 必填 | 参数描述 |
|---|---|---|---|
| Model | String | 是 | 模型名称 可选值：vidu2.0、vidu1.5 |
| Images | Array[String] | 是 | 图像 支持输入两张图，上传的第一张图片视作首帧图，第二张图片视作尾帧图，模型将以此参数中传入的图片来生成视频 注1: 首尾帧两张输入图的分辨率需相近，首帧图的分辨率/尾帧图的分辨率要在0.8～1.25之间。且图片比例需要小于1:4或者4:1； 注2: 支持传入图片URL（确保可访问）； 注3: 图片支持 png、jpeg、.jpg、webp格式； 注4: 图片大小不超过10M； |
| Prompt | String | 可选 | 文本提示词 生成视频的文本描述。 注：字符长度不能超过 1500 个字符 |
| Duration | Int | 可选 | 视频时长 默认 4，可选值：4、8 |
| Seed | Int | 可选 | 随机种子 当默认不传或者传0时，会使用随机数替代 手动设置则使用设置的种子 |
| Resolution | String | 可选 | 分辨率 默认 360p，可选值如下： vidu1.5 和 vidu2.0 4秒的视频可使用360p、720p、1080p vidu1.5 和 vidu2.0 8秒的视频仅可使用720p |
| MovementAmplitude | String | 可选 | 运动幅度 供 vidu1.5 和 vidu2.0模型可用 默认 auto，可选值：auto、small、medium、large 高动态性是 vidu 模型的特色之一，为了更好的服务不同的需求，我们开放了控制视频动态幅度的参数 |
请求示例：
def create_start_end2video(self):
action = "CreateStartEnd2video"
method = "POST"
param = {}
body = {
"Model": "vidu2.0",
"Images": [
"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/startend2video-1.jpeg",
"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/startend2video-2.jpeg"],
"Prompt": "The camera zooms in on the bird, which then flies to the right. With its flight being smooth and natural, the bird soars in the sky. with a red light effect following and surrounding it from behind.",
"Duration": "4",
"Seed": "0",
"Resolution": "720p",
"MovementAmplitude": "auto"
}
url = get_signature(action, self.ak, self.sk, method, self.url, param)
print("开始首尾帧, url is", url)
resp = requests.post(url, json=body)
result = json.loads(resp.content)
print(result)
return result
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
返回参数说明：
| 参数名 | 类型 | 说明 |
|---|---|---|
| TaskId | String | Vidu 生成的任务ID |
| State | String | 处理状态 可选值： created 创建成功 queueing 任务排队中 processing 任务处理中 success 任务成功 failed 任务失败 |
| Model | String | 本次调用的模型名称 |
| Prompt | String | 本次调用的提示词参数 |
| Images | Array[String] | 本次调用的图像参数 |
| Duration | Int | 本次调用的视频时长参数 |
| Seed | Int | 本次调用的随机种子参数 |
| Resolution | String | 本次调用的分辨率参数 |
| MovementAmplitude | String | 本次调用的镜头动态幅度参数 |
| CreatedAt | String | 任务创建时间 |
返回示例：
{
"Code": "Success",
"Msg": "success",
"Data": {
"TaskId": "802735183160721408",
"Type": "headtailimg2video",
"State": "created",
"Model": "vidu2.0",
"Style": "general",
"Prompt": "The camera zooms in on the bird, which then flies to the right. With its flight being smooth and natural, the bird soars in the sky. with a red light effect following and surrounding it from behind.",
"Images": [
"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/startend2video-1.jpeg",
"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/startend2video-2.jpeg"
],
"Duration": 4,
"Seed": 2042451130,
"AspectRatio": "16:9",
"Resolution": "720p",
"MovementAmplitude": "auto",
"CreatedAt": "2025-03-27T06:54:56.891814425Z"
},
"RequestId": "8AEE68EE-B3A6-43E6-8A12-E8D036DDC9FD"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# 7.CreateText2video
Action： CreateText2video
描述： 创建文生视频
请求地址： api.capitalonline.net/platform/vira_v2
请求方法： POST
请求参数：
| 参数名称 | 类型 | 必填 | 参数描述 |
|---|---|---|---|
| Model | String | 是 | 模型名称 可选值：vidu1.5、vidu1.0 |
| Style | String | 可选 | 风格 默认 general，可选值：general、anime general：通用风格，可以通过提示词来控制风格 anime：动漫风格，仅在动漫风格表现突出，可以通过不同的动漫风格提示词来控制 |
| Prompt | String | 是 | 文本提示词 生成视频的文本描述。 注：字符长度不能超过 1500 个字符 |
| Duration | Int | 可选 | 视频时长 默认 4，可选值：4、8 |
| Seed | Int | 可选 | 随机种子 当默认不传或者传0时，会使用随机数替代 手动设置则使用设置的种子 |
| AspectRatio | String | 可选 | 比例 默认 16:9，可选值如下： vidu1.0 可选值：16:9 vidu 1.5可选值：16:9、9:16、1:1 |
| Resolution | String | 可选 | 分辨率 默认 360p，可选值如下： vidu1.0 仅可使用360p vidu1.5 4秒的视频可使用360p、720p、1080p 8秒的视频仅可使用720p |
| DovementAmplitude | String | 可选 | 运动幅度 供 vidu1.5 模型可用 默认 auto，可选值：auto、small、medium、large 高动态性是 vidu 模型的特色之一，为了更好的服务不同的需求，我们开放了控制视频动态幅度的参数 |
请求示例：
def create_text2video(self):
action = "CreateText2video"
method = "POST"
param = {}
body = {
"Model": "vidu1.5",
"Style": "general",
"Prompt": "In an ultra-realistic fashion photography style featuring light blue and pale amber tones, an astronaut in a spacesuit walks through the fog. The background consists of enchanting white and golden lights, creating a minimalist still life and an impressive panoramic scene.",
"Duration": "4",
"Seed": "0",
"AspectRatio": "16:9",
"Resolution": "720p",
"MovementAmplitude": "auto"
}
url = get_signature(action, self.ak, self.sk, method, self.url, param)
print("开始文生视频, url is", url)
resp = requests.post(url, json=body)
result = json.loads(resp.content)
print(result)
return result
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
返回参数说明：
| 字段 | 类型 | 描述 |
|---|---|---|
| TaskId | String | Vidu 生成的任务ID |
| State | String | 处理状态 可选值： created 创建成功 queueing 任务排队中 processing 任务处理中 success 任务成功 failed 任务失败 |
| Model | String | 本次调用的模型名称 |
| Prompt | String | 本次调用的提示词参数 |
| Images | Array[String] | 本次调用的图像参数 |
| Duration | Int | 本次调用的视频时长参数 |
| Seed | Int | 本次调用的随机种子参数 |
| AspectRatio | String | 本次调用的 比例 参数 |
| Resolution | String | 本次调用的分辨率参数 |
| MovementAmplitude | String | 本次调用的镜头动态幅度参数 |
| CreatedAt | String | 任务创建时间 |
返回示例：
{
"Code": "Success",
"Msg": "success",
"Data": {
"TaskId": "802735821856743424",
"Type": "text2video",
"State": "created",
"Model": "vidu1.5",
"Style": "general",
"Prompt": "In an ultra - realistic fashion photography style featuring light blue and pale amber tones, an astronaut in a spacesuit walks through the fog. The background consists of enchanting white and golden lights, creating a minimalist still life and an impressive panoramic scene.",
"Images": [],
"Duration": 4,
"Seed": 976519438,
"AspectRatio": "16:9",
"Resolution": "720p",
"MovementAmplitude": "auto",
"CreatedAt": "2025-03-27T06:57:29.169077542Z"
},
"RequestId": "59945BBD-FC02-484B-AA8F-3BC542D74EEE"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# 8.CreateTemplate2video
Action： CreateTemplate2video
描述： 创建场景模版
请求地址： api.capitalonline.net/platform/vira_v2
请求方法： POST
请求参数：
| 参数名称 | 类型 | 必填 | 参数描述 |
|---|---|---|---|
| Template | String | 是 | AI 模版参数 用来指定特定场景，可选值如下： balloon_flyaway,musccartoon_doll,fiying,paperman,pinch,sakura_season,muscling,french_kiss,slice_therapy,beast_companion,bloom_magic,golden_epoch,oscar_gala,fashion_stride,star_carpet,flame_carpet,frost_carpet,exotic_princess,hugging, kissing, hulk, cap_walk, hulk_dive, captain_america, dreamy_wedding, romantic_lift, sweet_proposal, couple_arrival, cupid_arrow, lunar_newyear, pet_lovers, hug, kiss, dynasty_dress, wish_sender, love_pose, hair_swap, youth_rewind, morphlab, live_photo, emotionlab, live_memory, interaction, christmas |
| Images | Array[String] | 是 | 图像 模型将以此参数中传入的图片来生成视频。 注1：支持通过 URL 传入图片。但需要确保URL公网可访问(暂不支持 base64） 注2：图片支持 png、jpeg、.jpg、webp格式 注3：图片比例需要小于1:4或者4:1 ，且大小不超过10M。 |
| Prompt | String | 是 | 文本提示词 生成视频的文本描述。 注：字符长度不能超过 1500 个字符 |
| Seed | Int | 可选 | 随机种子 当默认不传或者传0时，会使用随机数替代 手动设置则使用设置的种子 |
| AspectRatio | String | 可选 | 比例 默认 16:9，可选值如下：16:9、9:16 * 不同 template 支持的可选值不同，详情见模版说明 |
| Area | String | 可选 | 异域公主特效专属参数 仅当 template 传 exotic_princess 时可用，可选值如下： 默认：auto, 可选：denmark,uk,africa,china,mexico,switzerland,russia,italy,korea,thailand,india,japan |
| Beast | String | 可选 | 与兽同行特效专属参数 仅当 template 传 beast_companion 时可用，可选值如下： 默认 auto,可选：bear,tiger,elk,snake,lion,wolf |
提示词输入指南：
- 必须输入提示词，且提示词格式尽量参考我们规定的格式，如果大幅缩短提示词会出现效果不佳的情况；
- 一般情况下，您无需改动提示词，我们提供的默认提示词对人像、物体，建筑等多种类型的图片都生效；
- 如果您有个性化的需求，也可以在不改变结构和大部分内容的情况下，对输入的提示词进行调整尝试。
场景提示词：
| 场景 | 类别名称 | 名称 | 请求提示 |
|---|---|---|---|
| muscling | 变身模板 | 变身肌肉男 | Video content\nThe video shows a man taking off his shirt, revealing his muscular chest.\n# Requirements\n1. If the garment is a shirt, he would first unbutton it before removing it, revealing his toned muscles underneath.\n2. Make sure that after the clothes are removed, they are thrown to one side of the frame.\n3. Motion Level：Large.\n4. The description of the 'Subject' should focus on the action of the person taking off the clothes, and then throwing the clothes aside while showing off their muscles. |
| captain_america | 变身模板 | 变身美队 | Video content\nThe figure in picture 1 flies in the sky, then slowly begins to transform his clothes to what he looks like in picture 2, spreads his wings, and then picks up a shield. \n# Requirements\n1.Accurately describe the clothing characteristics of the person in the first picture. \n2. Emphasize the changing process of clothing.\ n3.No superhero descriptions, just a precise description of the costume. \n4.The facial features are consistent with Figure 1, and the final clothing features are consistent with Figure 2. |
| hulk | 变身模板 | 变身浩克 | Video content\nThe character experiences a radical transformation where their body shatters into numerous fragments. From the dispersing pieces, a strong force emerges, remolding them into a much larger and more powerful form. The muscles enlarge and reshape, creating a huge, towering Red Giant. The remnants of the shredded body vanish into chaos, leaving only this powerful being with bulging muscles and a fierce look, wearing only tattered shorts. Its thunderous roar shakes the ground and debris swirls around, signifying the intense and violent appearance of this new, unstoppable form. |
| cap_walk | 变身模板 | 美队同行 | Video content\nTwo characters holding round shields side by side walk towards the camera，One of the characters flaps his wings behind him.The background is a war-torn ruin.\n# Requirements\n1.Emphasize that everyone has a shield in their hands.\n2.Accurately describe the appearance of the person based on the picture. |
| hulk_dive | 变身模板 | 浩克俯冲 | Video content\nThe red Hulk flies through the sky, with the character from Image 1 positioned firmly on his back. Hulk then leaps to the ground. Then cracks appeared in the ground.The character from Image 1 remains steadfastly perched on Hulk's shoulder, maintaining a secure grip around the red Hulk's neck.\n# Requirements\n1. Do not use uncertain words, such as 'seem', 'like', 'prepare', etc. n2. Emphasize that the character in picture 1 has been firmly seated on the Hulk's back. |
| exotic_princess | 变身模板 | 异域公主 | Video content\n Character [Detailed description of gender, facial features, and skin color in Figure 1] wearing [Description of hairstyle, headwear, clothing, and props in Figure 2], smiling in front of the camera, showing an elegant and noble state. |
| beast_companion | 变身模板 | 与兽为伍 | Video content\n The characters in Image 1 and Image 2 walk confidently side by side, slowly approaching the camera.\n# Requirements\n The setting is a modern fashion runway with a glossy white surface, surrounded by an audience seated in a dimly lit room. The atmosphere is sophisticated and focused, with the spotlight on the two characters as they make their way down the runway.\n# Requirements\n1.Please strictly follow my instructions; the image only supplements the character's appearance details.\n2.Camera Movement: Zoom out.\n3.Emphasize standing confidently，arrogant and look straight ahead.\n4.Do not include descriptions like holding hands.\n5.shot_size:Wide Shot.\n6.Emphasize that male roles are slightly higher than female roles.\n7.Emphasize starting with two characters side by side.\n8.Emphasize the character facing the camera. |
| cartoon_doll | 变身模板 | 变身Q版玩偶 | Video content\n The character in the picture jumped, turning into a smooth doll version of themselves.\n# Requirements\n1.Style:“3D Rendering, HD”.\n2.Ensure the character jumps in place. |
| french_kiss | 互动模板 | 法式热吻 | The two figures in the painting move closer and then passionately kiss, alternating with deep and firm intensity. |
| hugging | 互动模板 | 2.0 拥抱 | 视频内容\n画面中的两个主体转向彼此，并开始拥抱。\n# 要求\n将Motion Level设置为“Large” |
| kissing | 互动模板 | 2.0 亲吻 | 视频内容\n画面中的两个主体开始转向彼此，开始接吻，画面呈现充满爱意的氛围。\n# 要求\n1.亲吻时候，嘴唇的动作要彼此贴合。\n2.将Motion Level的值设置为“Large”. |
| interaction | 互动模板 | 比心 | 图片中的两个人[简要精准的外观描述]面对镜头，各自伸出一只手，合在一起在胸前比了一个爱心" |
| interaction | 互动模板 | 送玫瑰花 | 视频内容\n镜头左边的人物[简要精准的外观描述、性别描述]拿起一只玫瑰花转身送给图片右边的人物[简要精准的外观描述]，右边的人物同样转身，面对面接受玫瑰花\n# 要求1.Shot Size：镜头缓慢自然的变为Medium Shot；2.Camera Movement:根据图片初始镜头确定镜头是Zoom Out 还是Zoom In才能变为Medium Shot，如果初始镜头为近景则需要Zoom Out，如果初始就是Medium Shot则为None |
| bloom_magic | 创意模板 | 万物生花 | Many flowers elegantly and rapidly grow from various surfaces of the main subject in image 1, swaying in the wind, full of vitality. |
| bloom_doorobear | 创意模板 | 万物生萌芽熊 | Video content\n The person in picture one, looking directly at the camera without moving. Suddenly, a small sprout from picture three grows from the top of the person's head. Then, this sprout grows into the complete cartoon figure shown in the second image. The cartoon figure from the second image then lies on top of the person's head. The person or animal smiles happily. \n Requirements: \n1. Include the process of a small sprout growing from their head. \n2. The tiny cute bear character from Image 2 should fall onto their head as if descending from above. \n3. Ensure that the green succulent bear is tiny. \n4. If Figure 1 does not depict a person, update the subject field to reflect the actual subject. \n5. Motion Level: Small |
| golden_epoch | 写真模板 | 流金岁月 | Video content\n The character displays a unique charm of elegance and intelligence, confidently looking at the camera, and giving a slight smile. Vintage film style, Wong Kar-wai aesthetic style.\n# Requirements\n1.There is only one character. Accurately describe the character's appearance based on Figure 1, and accurately describe the character's clothing and background features based on Figure 2 \n2.Motion_level:Middle. |
| oscar_gala | 写真模板 | 金像盛典 | Video content\n The person in Figure One is dressed in the outfit from Figure Two, holding an Oscar statuette, standing at the center of the Oscar awards stage, smiling at the camera while delivering an acceptance speech.\n# Requirements\n1. A precise description of the person in Figure One, including their facial features, expression, hairstyle, and gender.\n2. Determine the type of attire based on the gender of the character in Image 1. If the character is female, she wears the gown from Image 2. If the character is male, he wears a stylish suit.\n3. Set Additional Information as 'None'. |
| fashion_stride | 写真模板 | 时尚T台 | Video content\n The character in Image 1 walks confidently in the scene of Image 2, slowly approaching the camera, with slow motion capturing the character's confident expression.\n# Requirements\n1.Emphasize the slow-motion effect of ultra-high-speed photography.\n2.Please strictly follow my instructions; the image only supplements the character's appearance details.\n3.Motion_Level:small.\n4.Camera Movement: Zoom out. |
| star_carpet | 写真模板 | 星光红毯 | Video content\n The character in Image 1 walks confidently in the scene of Image 2, slowly approaching the camera, with slow motion capturing the character's confident expression.\n# Requirements\n1.Emphasize the slow-motion effect of ultra-high-speed photography.\n2.Please strictly follow my instructions; the image only supplements the character's appearance details.\n3.Motion_Level:small.\n4.Camera Movement: Zoom out. |
| flame_carpet | 写真模板 | 烈焰红毯 | Video content\n The character in Image 1 walks confidently in the scene of Image 2, slowly approaching the camera, with slow motion capturing the character's confident expression.\n# Requirements\n1.Emphasize the slow-motion effect of ultra-high-speed photography.\n2.Please strictly follow my instructions; the image only supplements the character's appearance details.\n3.Motion_Level:small.\n4.Camera Movement: Zoom out. |
| frost_carpet | 写真模板 | 风雪红毯 | Video content\n It is snowing heavily in the sky, and the character in image 1 confidently walks down the red carpet, slowly approaching the camera, with slow motion capturing the character's confident expression'Environment':'The setting is a stunning winter landscape, where heavy snowflakes cascade from the sky, blanketing the ground in a soft white layer. The red carpet stretches out on a smooth, icy surface, contrasting sharply with the surrounding snow, creating a striking visual that draws attention to the confident figure walking towards the camera.' \n# Requirements\n1.Emphasize the slow-motion effect of ultra-high-speed photography.\n2.Please strictly follow my instructions; the image only supplements the character's appearance details.\n3.Motion_Level:small.\n4.Camera Movement: Zoom out. |
| sakura_season | 节日模板 | 樱花飘落 | Video content\n The camera pulls back, and pink cherry blossom petals gently fall from the top of the frame under a cherry blossom tree. The subject faces the camera, tilting their head upward to gaze at the sky while the petals drift down from above, and the subject smiles happily.\n# Requirements\n1.Emphasize the subject's upward head movement. \n2.Camera movement: Zoom out. \n3.Shot size: Wide shot.\n4.Motion Level: Large. |
| christmas | 节日模板 | 变身为圣诞老人 | 视频内容\n画面中的人物从下前方轻轻举起鲜红的布，动作干净利落地将其从头覆盖到全身，然后随着人物将红布迅速向下扯下，人物变成了充满节日气息的圣诞老人。\n# 要求\n1.Style设定为:Realistic, HD\n2.根据用户上传图片确定人物数量，不要出现[一群人]、[们]等代词而是精准地指出人物数量\n3.如果用户上传图片有多个人物，则他们需要一起举起红布，所有人都变身为圣诞老人。不要出现图片中没有的人物", |
| christmas | 节日模板 | 圣诞老人来送礼 | 视频内容\n镜头中人物看向右边，然后一个圣诞老人满面笑容地从右边走入画面，手中捧着一个精美的礼物盒。他轻轻将礼物递给画面中的人物，动作自然且充满温暖。镜头聚焦在接到礼物的人物，人物神情中充满惊喜与感激。画面捕捉到人物的微表情和互动细节。\n# 要求\n1.Style设定为:Realistic, HD\n2.根据用户上传图片确定人物数量，不要出现[一群人]、[们]等代词而是精准地指出人物数量\n3.如果用户上传图片有多个人物，则他们需要一起举起红布，所有人都变身为圣诞老人。不要出现图片中没有的人物", |
| christmas | 节日模板 | 圣诞节举杯庆祝 | 视频内容\n画面人物手里拿起香槟酒杯，庆祝圣诞快乐，随着镜头拉远，画面出现圣诞树等圣诞节日物品\n# 要求\n1.Take a step-by-step approach in your response\n2.以我的视频描述为第一要素，背景的描述统一、合理，不要描述两次.\n3.根据用户上传图片确定人物数量，不要出现[一群人]、[们]等代词而是精准地指出人物数量\n4.Motion Level 设定为：Middle\n5.如果用户上传图片有多个人物，每个人都需要拿起香槟酒杯。不要出现图片中没有的人物", |
| christmas | 节日模板 | 圣诞老人来拥抱 | 视频内容\n镜头中人物看向画面外，接着一个圣诞老人满面笑容地从画面外走入画面，然后和人物拥抱，动作自然且充满温暖，镜头聚焦在一个温暖的拥抱，画面捕捉到人物的的微表情和互动细节\n# 要求\n1.根据人物的位置和状态合理的设计动作，而不是突兀的直接拥抱，要先描写人物转变到一个合适拥抱的姿势\n2.Take a step-by-step approach in your response\n3.根据用户上传图片确定人物数量，不要出现[一群人]、[们]等代词而是精准地指出人物数量\n4.如果图片中有多个人物，则需要一起和圣诞老人拥抱。不要出现图片中没有的人物\n5.强调只有1个圣诞老人", |
| lunar_newyear | 节日模板 | 2025新年烟花 | 视频内容\n视频展示人物手持仙女棒 面对镜头，人物身后绽放新年烟花 烟花上写2025 采用远景视角 动作自然且充满温暖，画面捕捉到人物的的微表情和互动细节 \n# 要求1.根据人物的位置和状态合理的设计动作.2.Take a step-by-step approach in your response.3.根据用户上传图片确定人物数量，不要出现[一群人]、[们]等代词而是精准地指出人物数量.4.如果图片中有多个人物，则需要一起手持仙女棒。不要出现图片中没有的人物.5.如果图片展示了背景图，则设定为背景并详细描述.6.保证人物始终在画面中心. |
| lunar_newyear | 节日模板 | 双人举杯 | 视频内容\n视频展示新年餐桌上人物拿着香槟高脚杯，干杯庆祝，场面十分红火热闹，动作自然且充满温暖，画面捕捉到人物的的微表情和互动细节.\n# 要求1.根据人物的位置和状态合理的设计动作.2.Take a step-by-step approach in your response.3.根据用户上传图片确定人物数量，不要出现[一群人]，不要出现图片中没有的人物.4.如果图片中有多个人物，则需要一起举杯庆祝。每个只拿一只杯子.5.如果图片展示了背景图，则设定为背景并详细描述.6.保证人物始终在画面中心 颜色温馨自然喜庆，不要黑白色. |
| lunar_newyear | 节日模板 | 红包雨 | 视频内容\n视频展示人物推开屋门 门内在下金光闪闪的红包雨 洒在人物身上 人物很开心。人物动作自然且充满温暖，画面捕捉到人物的的微表情和互动细节 \n# 要求1.根据人物的位置和状态合理的设计动作.2.Take a step-by-step approach in your response.3.根据用户上传图片确定人物数量，不要出现[一群人]、[们]等代词而是精准地指出人物数量.4.不要出现图片中没有的人物.5.保证人物始终在画面中心.6.推开房门后才洒落红包雨，推开房门前不要蹦出东西.7.洒落的是红色的红包雨不是金币 .8.要有一把真实的门，要有打开房门的动作，红包从门外掉落. |
| love_pose | 节日模板 | 全家福比心 | 视频内容\n画中的角色面对镜头，抬起双手在胸前，做出比心的动作.\n# 要求-根据图片判断人物数量，如果有多个人，每个人物都要做出比心的动作。 |
| wish_sender | 节日模板 | 和财神比心 | 视频内容\n 视频展示了红衣服财神角色站在人物角色旁边，他们一起面对镜头,每个人伸出双手各自在自己胸前比心，动作自然且充满温暖。\n# 要求 1. 如果图片中有多个人物，则每个人各自在自己胸前比心。不要出现图片中没有的人物。2. 强调只有1个财神。3.如果图片展示了背景图，则设定为背景并详细描述。4. 保证人物和财神始终在画面中心。 |
| wish_sender | 节日模板 | 和财神拥抱 | 视频内容\n 镜头中人物看向画面外，接着一个财神满面笑容地从画面外走入画面，然后和人物拥抱，动作自然且充满温暖，镜头聚焦在一个温暖的拥抱，画面捕捉到人物的的微表情和互动细节。\n# 要求 1.根据人物的位置和状态合理的设计动作，而不是突兀的直接拥抱，要先描写人物转变到一个合适拥抱的姿势。 2.Take a step-by-step approach in your response. 3.根据用户上传图片确定人物数量，不要出现[一群人]、[们]等代词而是精准地指出人物数量。4.如果图片中有多个人物，则需要一起和财神拥抱。不要出现图片中没有的人物。5.强调只有1个财神。6.如果图片展示了背景图，则设定为背景并详细描述。 |
| wish_sender | 节日模板 | 财神送元宝 | 视频内容\n 镜头中人物看向右边，然后一个财神满面笑容地从右边走入画面，手中捧着一个元宝。他轻轻将元宝递给画面中的人物，人物充满惊喜的表情双手接过元宝，动作自然且充满温暖。镜头聚焦在接到元宝的人物。画面捕捉到人物的微表情和互动细节。\n# 要求 1.Take a step-by-step approach in your response. 2.Motion Level: Middle. 3.首先描述照片中人物状态，然后描述财神走入画面。4.根据用户上传图片确定人物数量，不要出现[一群人]、[们]等代词而是精准地指出人物数量。5.如果用户上传图片有多个人物，则他们自然的聚在一起看着元宝，人物神情中都充满惊喜与感激。画面捕捉到每个人物的微表情和互动细节。不要出现图片中没有的人物。 6.强调只有1个元宝。7.如果图片展示了背景图，则设定为背景并详细描述。8.财神和人物始终在画面中心。 |
| wish_sender | 节日模板 | 财神发红包 | 视频内容\n 视频展示一个财神角色与人物的互动。财神站在人物旁边，不断抛洒红包，红包如雨点般洒下。人物伸出双手接住2个沉甸甸的红包，脸上露出惊喜的笑容。红色喜庆背景，充满了中国春节元素，红包的细节。\n# 要求 1.根据图片精准描述人物外观。2.根据图片精准描述财神外观和红包外观。3.人物和财神始终保持在画面中心。4.如果图片展示了背景图，则设定为背景并详细描述。 |
| wish_sender | 节日模板 | 财神发金币 | 视频内容\n 视频展示一个财神角色与人物的互动。财神在人物旁边站立着举起双手向上洒金币，然后金币如雨点般从空中散落下来，主体人物伸出双手开心的抓住2个金币拿在手里，脸上露出惊喜的笑容。红色喜庆背景，充满了中国春节元素，金币细节。\n# 要求 1.根据图片精准描述人物外观。2.根据图片精准描述财神外观和金币外观。3.如果图片展示了背景图，则设定为背景并详细描述。4.人物和财神时候总保持在画面中心。5.motion_level:small. |
| dynasty_dress | 节日模板 | 古风换装 | 视频内容\n一个角色穿着服装和鞋子面对镜头摆pose，眨眨眼睛，甜美微笑\n# 要求 - 对角色的面部细节详细描述，对服装配饰的各种细节要尽量精准详细的描述.- 如果图片展示了[服装、手提包、配饰、帽子、鞋子]，需要出现在对人物的服装描述中.- 如果图片展示了背景图，则设定为背景并详细描述。- 只有1个角色！不要出现任何复数代词.- Shot Size 为：Wide Shot- 角色不要有任何手部动作、腰部动作,强调自然的微笑. |
| youth_rewind | 节日模板 | 童年回忆 | Video content\ n The subject(s) is/are facing the camera, appearing as their 3-year-old self, wearing a red cotton-padded jacket, holding burning sparklers in both hands, and joyfully dancing in the snowy courtyard. The sparklers flicker brightly, casting a warm glow on their happy, smiling faces. The subject(s) performs lively, natural movements, such as waving the sparklers while skipping around, always remaining in the center of the frame. The scene is set in a snowy village courtyard during a festive winter evening, as shown in the provided background. Snow covers the ground and rooftops, while red lanterns hang overhead, glowing warmly in the golden sunlight of dusk. The wooden doors of nearby houses are adorned with festive decorations. The overall ambiance is filled with a nostalgic and joyful Chinese New Year atmosphere. The warm orange tones from the sunlight and the red lanterns harmonize with the vibrant movements of the subject(s), enhancing the festive mood. The steady camera ensures the subject(s) stays at the center of the frame throughout the joyous performance. \ n #Requirements\ 1. The subject(s) in the picture may be pets or one or more people. Generate according to the actual situation in the reference image. 2. The subject(s) should smile and immerse themselves in the festive atmosphere of Chinese New Year. 3. The subject(s) must always remain at the center of the frame, even while joyfully dancing. 4.The subject(s), including any pets, must wear red New Year cotton-padded jackets. |
| couple_arrival | 节日模板 | AI 情侣拥抱 | 视频内容\n 主体站在画面中央，正面朝向镜头。主体的伴侣人从画面右侧以放松的步伐逐渐走入画面，接近站在中心的人，然后相互拥抱，动作充满温暖和爱意。拥抱完成后，两人转向镜头，正脸朝向镜头，展现出轻松与友好的氛围。主体的伴侣形象为：{user_input}\n# 要求 1.如果没有特别说明，针对主体伴侣，主体伴侣跟主体的种族、年龄、肤色应该是匹配的。主体伴侣的性别一般是跟主体是相反的。2.主体伴侣的数量跟主体的数量应该是一致的，如果图片中是一个主体，那么主体伴侣应该也是一个。3.拥抱完成后，主体伴侣跟主体一样正脸朝向镜头。 |
| dreamy_wedding | 节日模板 | 梦幻婚礼 | 视频内容\n 画面中的两个角色穿着婚纱和礼服，在草地上拍照。\n# 要求 1.根据图片严谨判断主体数量与性别，精准描述主体面部特点。 |
| romantic_lift | 节日模板 | 浪漫公主抱 | 视频内容\n 画面中的有两个角色，其中一个角色使用公主抱[Princess carry]的动作抱起旁边的角色。\n# 要求 1. 根据图片精准描述角色外观，性别。2. 如果两个角色都是男生或者都是女生，则描述右边的角色抱起左边的角色。3.如果两个角色是一男一女，则描述男性角色抱起女性角色。 |
| sweet_proposal | 节日模板 | 甜蜜求婚 | 视频内容\n 画面中的有两个角色，其中一个角色1[精准描述外观和性别]突然掏出红色的戒指盒，表情真挚的单膝下跪向旁边的角色2[精准描述外观和性别]求婚，角色2表现得很开心[描述惊喜的表情动作] 。\n# 要求 - 严格根据图片判断人物数量，性别。- 如果图片中有男性角色，则指定该男性角色为角色1。如果图片中只有女性角色，则随机指定一个女性为角色1。 |
| couple_arrival | 节日模板 | AI情侣送花 | 视频内容\n 镜头中人物看向镜头，接着该人物的{伴侣}满面笑容地从画面外走入画面，递给了人物一束花，人物感到惊喜，动作自然且充满温暖，画面捕捉到人物的的微表情和互动细节。伴侣形象为：{user_input} \n# 要求1.根据人物的位置和状态合理的设计动作，而不是突兀的直接出现。2.如果镜头中的人物是女性，那么{伴侣}就是一个帅气的与之年龄相仿的男性；如果镜头中的人物是男性，那么{伴侣}就是一个美丽的与之年龄相仿的女性，如果用户输入了{伴侣}形象，则按照用户输入的为准。3.Take a step-by-step approach in your response. 4.最后画面中的人数为2人。 |
| couple_arrival | 节日模板 | AI 情侣接吻 | 视频内容\n 主体的视线、动作从原来的状态自然地转变为迎接主体的伴侣，主体的伴侣从画面左侧或者右侧以放松的步伐逐渐走入画面，接近站在中心的人。两人自然地接吻，动作充满温暖和爱意。接吻完成后，两人一同转向镜头，正脸朝向镜头，展现出轻松与友好的氛围。主体的伴侣形象为：{user_input}\n# 要求 1.如果没有特别说明，针对主体伴侣，主体伴侣与主体的种族、年龄、肤色应该相似。2.主体伴侣的性别通常与主体相反。主体伴侣的数量与主体数量一致，若图片中是一个主体，则主体伴侣应为一个。3.接吻完成后，主体伴侣与主体一样正脸朝向镜头。4.如果参考图片的镜头类型为近景，镜头在伴侣走近时可以稍微拉远，调整视角以容纳两人完整的画面。 |
| couple_arrival | 节日模板 | AI 情侣挥手 | 视频内容\n 主体的视线和动作自然过渡，迎接主体的伴侣。主体的伴侣从画面一侧以放松的步伐逐渐进入画面，靠近主体。两人自然地对视，流露出亲密的情感，随后一同转向镜头，面带温暖的微笑。两人用靠近彼此的手同时向镜头挥手，动作协调流畅，传递出轻松友好的氛围。主体的伴侣形象为：{user_input}\n# 要求：1. 如果没有特别说明，主体伴侣应与主体在种族、年龄、肤色上匹配。2. 主体伴侣的性别通常与主体相反。3. 主体伴侣的数量应与主体一致，例如，若画面中有一位主体，则主体伴侣也应为一位。4. 主体伴侣与主体保持一致的动作和姿态，正面面向镜头并打招呼。 |
| cupid_arrow | 节日模板 | 丘比特之箭 | 视频内容\n 一支粉色丘比特之箭极速从镜头左边飞进来射入左边角色的胸口，角色微微惊讶，捂住胸口，然后心动的红晕浮现，氛围暧昧。\n# 要求 1.先描写人物被射中，然后描写转变惊讶心动。2.如果图片中有两个角色，被箭头射中的角色应该深情的看向对方。\n# 环境 -浪漫背景（如云朵、玫瑰花瓣、星光）。-空气中漂浮着粉色或金色的光点。-柔和的光晕环绕。-爱心符号或梦幻气泡渐渐浮现。 |
| pet_lovers | 节日模板 | 萌宠恋人 | 视频内容\n 两只可爱的宠物以后肢站立，呈现类似人类腿部的形态，前肢则类似人类手臂的结构，身穿配套的情侣装。它们面对镜头，彼此互动紧密，例如前肢轻轻拥抱或靠在一起，整体呈现出拟人化的亲密氛围。 |
| slice_therapy | 趣味模板 | 解压切切 | Video content\n At the beginning of the video, one hand holds the subject in the image, while another hand reaches out from off-screen, using a tool to cut the surface of the subject. As the process continues, the interior or layers of the subject gradually become visible, showcasing rich colors, patterns, and textures. Throughout the process, the hand remains steady, carefully operating the tool, gradually revealing the complex design inside. |
| morphlab | 趣味模板 | 膨胀 | 视频内容\n画面中主体开始膨胀变形，变得越来越大，越来越圆，就像一个气球，慢慢飘了起来\n# 要求\n1.根据用户上传图片确定主体数量,每个主体都要膨胀\n2.Motion Level 设定为:Middle\n3.以我的视频内容为第一要素，背景的描述统一、合理，不要描述两次. |
| morphlab | 趣味模板 | 捏捏 | 视频内容\n画面开始，主体静止不动。随后，一双大手出现，将主体像橡皮泥般抓住并挤压。\n随着主体逐渐缩小，被夹在手指间柔软变形\n# 要求\n1.根据用户上传图片确定主体数量,每个主体都要被捏扁\n2.Motion Level 设定为:Middle\n3.以我的视频内容为第一要素，背景的描述统一、合理，不要描述两次. |
| morphlab | 趣味模板 | 爆炸 | 视频内容\n画面开始主体突然爆炸，细碎的颗粒爆炸开来\n# 要求\n1.根据用户上传图片确定主体数量,每个主体都要爆炸\n2.Motion Level 设定为:Middle\n3.以我的视频内容为第一要素，背景的描述统一、合理，不要描述两次. |
| morphlab | 趣味模板 | 融化 | 视频内容\n画面中主体慢慢地开始融化，最终形成一个表面光滑的水坑\n# 要求\n1.根据用户上传图片确定主体数量,每个主体都要融化\n2.Motion Level 设定为:Middle\n3.以我的视频内容为第一要素，背景的描述统一、合理，不要描述两次. |
| hair_swap | 趣味模板 | AI换发 | 视频内容\n角色正对镜头不动，眨眨眼睛，头发缓慢转变为“{Dirty Orange}”的“{Curly Wool Hair}”发型\n# 要求 角色静静地面对镜头，目光平和，眨眨眼睛，头发的变换成为画面的焦点，呈现出一场优雅的发型演化表演。 |
| balloon_flyaway | 趣味模板 | 变成气球飞走了 | Video content\n The subject in the image turns into a balloon and flies away while spinning.\n# Requirements\n1.Determine the style solely based on the image.\n2.Determine the number of subjects based on the image, and each subject should turn into a balloon and fly away. |
| flying | 趣味模板 | 飞行 | Video content\n The character in the image floats and flies like a superhero.\n# Requirements\n1.Camera Movement：track-up shot.\n2.Motion Level：Large. |
| paperman | 趣味模板 | 纸片人特效 | Video content\n The character is actually a motionless paper puppet. A large hand appears from the left and removes the subject from the scene to the left, while the shot remains steady.\n# Requirements\n Motion Level: Large. |
| pinch | 趣味模板 | 2.0 捏捏 | Video content\n The scene begins, with the subject remaining still. Then, a pair of large hands appear, grabbing the subject and squeezing it flat like clay.As the subject gradually shrinks, it becomes soft and deformed, pinched between the fingers.\n# Requirements\n1.Determine the number of subjects based on the user's uploaded image, and each subject must be pinched flat.\n2. Motion Level set to: Middle\n3. Take my video content as the primary element, and ensure that the background description is consistent and reasonable, without repeating the description. |
| live_photo | 动态模板 | 甜美微笑 | 主体面对镜头，露出了甜美动人的微笑 |
| emotionlab | 动态模板 | 恐惧 | 视频内容\n画面主体的表情开始慢慢变化，变得恐惧害怕，眼神里满是无助和惊慌，害怕的大声尖叫\n# 要求\n1.根据用户上传图片确定主体数量、人物性别、shot_size,每个主体都是同样的表情变化\n2.Motion Level 设定为:Middle\n3.以我的视频内容为第一要素，背景和图片保持一致，不要变化，不要描述两次\n4.镜头固定不要移动", |
| emotionlab | 动态模板 | 微笑 | 视频内容\n图中的人物逐渐露出特别惊讶的表情，眼睛睁大，嘴巴微微张开，透出难以置信的神情。\n# 要求\n1.根据用户上传图片确定主体数量、人物性别、shot_size,每个主体都是同样的表情变化\n2.Motion Level 设定为:Middle\n3.以我的视频内容为第一要素，背景的描述统一、合理，不要描述两次\n4.镜头固定不要移动,人物主要是表情变化，人物表情变化要自然 |
| emotionlab | 动态模板 | 狂笑 | 视频内容\n画面主体的表情开始慢慢变化,表情逐渐放松，嘴角轻轻上扬，眼神变得柔和，微笑逐渐展现出温和与宁静的氛围。\n# 要求\n1.根据用户上传图片确定主体数量、人物性别、shot_size,每个主体都是同样的表情变化\n2.Motion Level 设定为:Middle\n3.以我的视频内容为第一要素，背景的描述统一、合理，不要描述两次\n4.镜头固定不要移动\n5.根据人物初始状态选择比较微小的微笑，还是比较开朗的微笑.不要过于夸张的微笑", |
| emotionlab | 动态模板 | 惊讶 | 视频内容\n画面主体的表情开始慢慢变化,随着心情的放松，眉头慢慢舒展，嘴角开始上扬。然后他的笑容逐渐扩大，眼睛也变得更加明亮，仿佛看到了什么有趣的事物。最终，他大笑起来，嘴巴张得大大的，露出洁白的牙齿，动作夸张\n# 要求\n1.根据用户上传图片确定主体数量、人物性别、shot_size,每个主体都是同样的表情变化\n2.Motion Level 设定为:Middle\n3.以我的视频内容为第一要素，背景的描述统一、合理，不要描述两次\n4.镜头固定不要移动,人物表情变化要自然 |
| live_photo | 动态模板 | 风动 | 主体头发丝被风朝着某一个方向微微吹动 |
| live_photo | 动态模板 | 镜头动 | 镜头缓缓拉近,风轻轻吹着主体 |
| live_photo | 动态模板 | 走路 | 视频内容\n画面主体，正对镜头走模特步\n# 要求\n1.根据img图片人物状态，设计合适的镜头运动，镜头应该慢慢转变为中景或者牛仔镜头【拉远或者推进】能够显露出人物的大半个身体\n2.根据img图片人物状态，设计合理的动作转变，最终人物应当面对镜头走模特步\n3.严格根据图片确定人物外观，不要出现图片没有的人物 |
| live_memory | 动态模板 | 老照片动起来 | Video content\n 视频中的人物们，简单互动，微笑看着屏幕。\n Requirements: \n1.严格根据图片判断有多少个人物，精准简要的描述人物外观。\n2.Motion Level ：Middle |
| orbit | 电商模板 | 镜头环绕 | The product in the image remains stationary while the camera moves counterclockwise around it. |
| zoom_in | 电商模板 | 镜头推进 | Video content\n The product remains completely stationary while the camera zooms in to showcase it.\nRequirement:\n1. Camera Movement: Zoom in |
| ai_outfit | 电商模板 | 虚拟试衣 | Video content\n 一个模特穿着服装自信的走向镜头，脚步稳健，手臂自然摆动。\n Requirements: \n1. 对服装配饰的各种细节要尽量精准详细的描述，对角色的面部细节详细描述。\n2.如果图片展示了[服装、手提包、配饰、帽子、鞋子]，需要出现在对人物的服装描述中。 \n3.如果图片没有展示所有服装，则针对性以提供服装设计合适的搭配服装，例如只提供了上衣，则要设计对应的裤子、裙子等。 \n4.如果有环境图，则设定为背景。如果没有环境图片，提供一个简洁白色背景，不要出现白布之类的描述。 \n5.只有1个角色，不要出现任何复数代词。 \n6.Shot Size 为：Wide Shot.\n7.camera movement：zoom out |
请求示例：
def create_template2video(self):
action = "CreateTemplate2video"
method = "POST"
param = {}
body = {
"Template": "hugging",
"Images": ["https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/scene-template/hug.jpeg"],
"Prompt": "Video content\\n画面中的两个主体转向彼此，并开始拥抱# 要求\\n将Motion Level设置为“Large”",
"Seed": "0"
}
url = get_signature(action, self.ak, self.sk, method, self.url, param)
print("开始场景模版, url is", url)
resp = requests.post(url, json=body)
result = json.loads(resp.content)
print(result)
return result
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
返回参数说明：
| 字段 | 类型 | 描述 |
|---|---|---|
| TaskId | String | Vidu 生成的任务ID |
| State | String | 处理状态 可选值： created 创建成功 queueing 任务排队中 processing 任务处理中 success 任务成功 failed 任务失败 |
| Template | String | 本次调用的场景参数 |
| Prompt | String | 本次调用的提示词参数 |
| Images | Array[String] | 本次调用的图像参数 |
| Seed | Int | 本次调用的随机种子参数 |
| AspectRatio | String | 本次调用的 比例 参数 |
| CreatedAt | String | 任务创建时间 |
返回示例：
{
"Code": "Success",
"Msg": "success",
"Data": {
"TaskId": "802750348811857920",
"State": "created",
"Template": "kissing",
"Prompt": "Video content\\n画面中的两个主体转向彼此，并开始拥抱# 要求\\n将Motion Level设置为“Large”",
"Images": ["https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/scene-template/hug.jpeg"],
"Seed": 0,
"CreatedAt": "2025-03-27T07:55:12.662818834Z"
},
"RequestId": "00963827-26B2-49EA-8BE5-2388625E3119"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
# 9.CreateUpscale
Action： CreateUpscale
描述： 创建智能超清
请求地址： api.capitalonline.net/platform/vira_v2
请求方法： POST
请求参数：
| 参数名称 | 类型 | 必填 | 参数描述 |
|---|---|---|---|
| Model | String | 是 | 模型名称 可选值：Vidu1.0 |
| CreationId | String | 是 | 生成物 id 注1：仅支持输入 360p 任务生成的 id 注2：从查询任务接口获取 |
请求示例：
def create_upscale(self, creation_id):
action = "CreateUpscale"
method = "POST"
param = {}
body = {
"Model": "vidu1.0",
"CreationId": creation_id
}
url = get_signature(action, self.ak, self.sk, method, self.url, param)
print("开始智能超清, url is", url)
resp = requests.post(url, json=body)
result = json.loads(resp.content)
print(result)
return result
1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
返回参数说明：
| 字段 | 类型 | 描述 |
|---|---|---|
| TaskId | String | Vidu 生成的任务ID |
| State | String | 处理状态 可选值： created 创建成功 queueing 任务排队中 processing 任务处理中 success 任务成功 failed 任务失败 |
| Model | String | 本次调用的模型参数 |
| CreatedAt | String | 任务创建时间 |
返回示例：
{
"Code": "Success",
"Msg": "success",
"Data": {
"TaskId": "802752300262125568",
"State": "created",
"Model": "vidu1.0",
"CreationId": "802750400343076864",
"CreatedAt": "2025-03-27T08:02:57.927641916Z"
},
"RequestId": "4B82953A-D09D-4C71-915C-A26A15BB184E"
}
1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
# 10.QueryTask
Action： QueryTask
描述： 查询任务
请求地址： api.capitalonline.net/platform/vira_v2
请求方法： POST
请求参数：
| 参数名称 | 类型 | 必填 | 参数描述 |
|---|---|---|---|
| TaskId | string | 是 | 任务id |
请求示例：
def QueryTask(self, task_id):
action = "QueryTask"
method = "POST"
param = {}
body = {
"TaskId": task_id
}
url = get_signature(action, self.ak, self.sk, method, self.url, param)
print("开始查询任务, url is", url)
resp = requests.post(url, json=body)
result = json.loads(resp.content)
print(result)
return result
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
返回参数说明：
| 字段 | 子字段 | 类型 | 描述 |
|---|---|---|---|
| Id | String | 任务ID | |
| State | String | 处理状态 可选值： created 创建成功 queueing 任务排队中 processing 任务处理中 success 任务成功 failed 任务失败 | |
| ErrCode | String | 错误码，具体见错误码表 | |
| Creations | Array | 生成物结果 | |
| Id | String | 生成物id，用来标识不同的生成物 | |
| Url | String | 生成物URL， 一个小时有效期 | |
| CoverUrl | String | 生成物封面，一个小时有效期 |
返回示例：
{
"Code": "Success",
"Msg": "success",
"Data": {
"State": "success",
"ErrCode": "",
"Creations": [
{
"Id": "801940776257875968",
"Url": "https://prod-ss-vidu.s3.cn-northwest-1.amazonaws.com.cn/infer/tasks/25/0325/02/801940406106337280/creation-01/video.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIARRHG6JR7EMNHVUWT%2F20250326%2Fcn-northwest-1%2Fs3%2Faws4_request&X-Amz-Date=20250326T084352Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host&response-cache-control=max-age%3D86400&response-content-disposition=attachment%3Bfilename%3Dvidu-general-4-2025-03-25T02%253A18%253A15Z.mp4&x-id=GetObject&X-Amz-Signature=67ee7906b457d8a1c71805ab134ee473079f939ace7ffda29ea44ce27a977df3",
"CoverUrl": "https://prod-ss-vidu.s3.cn-northwest-1.amazonaws.com.cn/infer/tasks/25/0325/02/801940406106337280/creation-01/cover.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIARRHG6JR7EMNHVUWT%2F20250326%2Fcn-northwest-1%2Fs3%2Faws4_request&X-Amz-Date=20250326T084352Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&response-cache-control=max-age%3D86400&x-id=GetObject&X-Amz-Signature=5e23701c843314058b3753b59479c0f2aacbc483a5b986befc387b4ea214d8d7"
}
],
"Id": "801940406106337280"
},
"RequestId": "269fd971b83375a41c318be245376420"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17