视频生成接口文档

更新时间：2024-12-25

本文档提供的接口用于图文生成视频的场景，如果需要接入使用，请联系百度云VOD。

以下接口均不做长期服务保证，在不久的将来我们会提供更完善的视频生成服务API。

Endpoints

https://bdttv.exp.bcevod.com

API 常见报错信息

HTTP CODE	错误码	错误信息	错误描述
400	BadRequest	bad request	不合法的请求
400	FieldLacking	field is missing or empty: {{.fields}}	缺少字段，具体字段见错误信息
400	FieldUnwanted	unwanted field: {{.fields}}	不需要传某些字段，具体字段见错误信息
400	FieldItemCountOutOfRange	field item count out of range: {{.fields}}	字段超限制
400	PageSizeOutOfRange	page size out of range	图像尺寸有问题。要求：图片大小小于 50M, 格式只支持 JPG/PNG, 图片长宽比需要小于 1:4 或者 4:1
400	OperationInProcess	operation in process, please retry later	请求在处理中
400	TaskPromptPolicyViolation	prompt policy violation	Prompt 触发安审风控
400	ImageFormatInvalid	invalid image format	图像格式不符合要求
400	AuditSubmitIllegal	submit is illegal	输入没有通过安全审核
400	CreditInsufficient	insufficient credits	额度不足，请联系服务方
400	CreationPolicyViolation	creation policy violation	生成物触发风控
401	Unauthorized	unauthorized	未鉴权
403	Forbidden	forbidden	请求没有权限
404	TaskNotFound	task not found	Task id 没找到
404	CreationNotFound	creation not found	Creation id 没找到
409	Conflict	resource conflict	资源主键冲突
429	QuotaExceeded	quota exceeded	超过并发限制。请联系商务
429	TooManyRequests	too many requests	请求太频繁
429	SystemThrottling	system is throttling	资源超过限制
499	Canceled	request canceled by client	请求被取消

创建任务接口支持模型

模型版本	任务类型	时长	分辨率
1.0	text2video	4, 8
1.0	character2video	4, 8
1.0	img2video	4, 8
1.5	text2video	4	512, 720p, 1080p
1.5	text2video	8	720p
1.5	character2video	4	512, 720p, 1080p
1.5	character2video	8	720p
1.5	headtailimg	4	512, 720p, 1080p
1.5	headtailimg	8	720p
1.5	img2video	4	512, 720p, 1080p
1.5	img2video	8	720p

512 即基础分辨率为 512*512，与 360p 接近。

创建场景任务接口支持场景

场景大类	细分类别	输入图片张数	生成视频时长	生成视频分辨率	生成视频比例
拥抱（hug）	拥抱	1	4s	360p	与输入图片比例相同
亲吻（kiss）	亲吻	1	4s	360p	与输入图片比例相同
圣诞特效（christmas）	变身为圣诞老人	1	4s	360p	与输入图片比例相同
	圣诞老人来送礼	1	4s	360p	与输入图片比例相同
	圣诞节举杯庆祝	1	4s	360p	与输入图片比例相同
	圣诞老人来拥抱	1	4s	360p	与输入图片比例相同
变形特效（morphLab）	膨胀	1	4s	360p	与输入图片比例相同
	捏捏	1	4s	360p	与输入图片比例相同
	爆炸	1	4s	360p	与输入图片比例相同
	融化	1	4s	360p	与输入图片比例相同
实况照片（live_photo））	甜美微笑	1	4s	720p	与输入图片比例相同
	风动	1	4s	720p	与输入图片比例相同
	镜头动	1	4s	720p	与输入图片比例相同
	走路	1	4s	720p	与输入图片比例相同
情绪特效（emotionlab）	恐惧	1	4s	360p	与输入图片比例相同
	微笑	1	4s	360p	与输入图片比例相同
	狂笑	1	4s	360p	与输入图片比例相同
	惊讶	1	4s	360p	与输入图片比例相同
复活老照（live_memory）	老照片动起来	1	4s	360p	与输入图片比例相同

API 认证方式

Basic Authentication

每个用户都将被分配一个 username 和 password，这个将被用于 API 请求的签名验证，签名算法为 Basic Auth。

在每个请求的头部添加以下 Header：

Authorization: Basic base64(<username>:<password>)

例如：

Authorization: Basic YWJjOnF3ZQo

接口

创建任务接口

请求方式


网络协议	https
请求方法	POST
请求地址	/ent/v1/tasks
请求数据格式	application/json
响应数据格式	application/json

请求头

字段	值	描述
Content-Type	application/json
Authorization	Basic {token}	将 {token} 替换为 Basic auth token

请求体

字段	字段类型	是否必填	描述
type	string	是	任务类型。可选值 text2video/img2video/character2video/headtailimg2video/upscale。img2video 是根据指定图片的整体风格和包含的内容生成新的视频。 character2video 是参考指定图片的参照物（人、物、动物······）的样式保持一致，其他的背景环境和内容是靠描述词来控制生成视频。headtailimg2video 是上传首尾两张图片，生成的视频会使用这两张图来作为视频的首帧和尾帧来生成视频。upscale 是把一个 512 分辨率的视频。超分补帧修复到 1080p，24 帧。
model	string	否	模型类型，1.5 版本该字段可忽略。任务类型为 text2video/img2video/character2video/headtailimg2video 时可选值 vidu-high-performance，任务类型为 upscale 时可选值为 stable
model_version	string	否	模型版本，可选值 1.0/1.5
style	string	否	风格。只有 text2video 任务需要填写，可选值 general/anime
input	struct	是	任务输入。一个结构体，包含如下字段
+ seed	int	否	随机种子。不传或传 0 则使用随机数替代，手动设置则使用设定的种子
+ enhance	bool	否	是否使用提示增强功能。默认值为 true, 启用提示增强功能
+ creation_id	int	否	生成物 ID。如果提交 upscale 任务时则必填，提交其他任务不用填
+ multi_image_boost	bool	否	是否开启多主体参考
+ prompts	array	否	提示词。是一个结构体数组，每个元素包含如下字段
++ type	string	是	提示词类型。text/image
++ content	string	是	提示词内容。当 type 为 text 时，content 为文本内容，content 长度不能大于 1500 个字符。当 type 为 image 时，content 为图像 URL（需要确保 URL 公可访问）或者上传图片的结果 URI。图片格式仅支持 JPG, PNG，且图片需要小于 50M，图片长宽比需要小于 1:4 或者 4:1。当提交 character2video 任务时，图片尺寸不能小雨 128*128，比例需要小于 1:16 或 16:1
output_params	struct	否	输出设置。当提交 text2video, img2video 任务时必填
+ sample_count	int	是	生成视频数量。目前仅支持 1
+ duration	int	是	视频时长，单位秒。目前支持 4, 8
+ aspect_ratio	string	否	比例，仅 1.5 模型支持。默认`16:9`，支持 `16:9`, `9:16`, `1:1`
+ resolution	string	是	视频分辨率，仅 1.5 模型支持。可选值 512/720p/1080p
+ movement_amplitude	string	否	运动幅度，仅 1.5 模型支持。可选值 auto/small/meduim/large

响应体

字段	类型	描述
id	string	任务 ID, 系统生成
type	string	提交的任务类型
state	string	任务状态
model	string	提交任务的 model
style	string	提交任务的风格
input	struct	提交任务的 input
output_params	struct	提交任务的输出设置
err_code	string	错误码，具体见错误码表
creations_count	int	成功生成的生成物数量
created_at	string	任务创建时间

响应示例

{
  "id": "2469692989739603",
  "type": "text2video",
  "state": "created",
  "model": "vidu-high-performance",
  "style": "general",
  "moderation": false,
  "input": {
    "creation_id": "0",
    "prompts": [
      {
        "type": "text",
        "content": "generate five iphone",
        "negative": false
      }
    ],
    "seed": 7661810195,
    "enhance": true
  },
  "output_params": {
    "sample_count": 1
  }
}

创建场景任务接口

请求方式


网络协议	https
请求方法	POST
请求地址	/ent/v1/scenes/tasks
请求数据格式	application/json
响应数据格式	application/json

请求头

字段	值	描述
Content-Type	application/json
Authorization	Basic {token}	将 {token} 替换为 Basic auth token

请求体

字段	字段类型	是否必填	描述
scene	string	是	场景，用来指定专门的场景，支持 hug、kiss、christmas、morphLab，具体见文档开头的支持场景说明
input	struct	是	任务输入。一个结构体，包含如下字段
+ prompts	array	否	提示词。是一个结构体数组，每个元素包含如下字段
++ type	string	是	提示词类型。text/image
++ content	string	是	提示词内容。当 type 为 text 时，content 为文本内容，content 长度不能大于 1500 个字符。当 type 为 image 时，content 为图像 URL（需要确保 URL 公可访问）或者上传图片的结果 URI。图片格式仅支持 JPG, PNG，且图片需要小于 50M，图片长宽比需要小于 1:4 或者 4:1。当提交 character2video 任务时，图片尺寸不能小雨 128*128，比例需要小于 1:16 或 16:1

响应体

字段	类型	描述
id	string	任务 ID, 系统生成
type	string	提交的任务类型
input	struct	提交任务的 input
output_params	struct	提交任务的输出设置
err_code	string	错误码，具体见错误码表
creations_count	int	成功生成的生成物数量
created_at	string	任务创建时间

查询任务接口

请求方式


网络协议	https
请求方法	GET
请求地址	/ent/v1/tasks/{id}/creations
请求数据格式	application/json
响应数据格式	application/json

请求头

字段	值	描述
Content-Type	application/json
Authorization	Basic {token}	将 {token} 替换为 Basic auth token

请求参数

字段	类型	是否必选	描述
id	string	是	任务 id，由创建任务接口创建成功返回

响应体

字段	类型	描述
state	string	任务状态。created/queueing/scheduling/processing/success/failed，分别表示创建成功/排队中/调度中/处理中/生成成功/生成失败
err_code	string	错误码，具体见错误码表
creations	array	生成物结果
+ id	string	生成物 id，用来标识不同的生成物
+ url	string	生成物 URL，一个小时有效期
+ cover_url	string	生成物封面，一个小时有效期

响应示例

{
  "state": "success",
  "err_code": "",
  "creations": [
    {
      "id": "246969811756349",
      "url": "https://dev-ss-vidu.s3.cn-northwest-1.amazonaws.com.cn/infer/tasks/24/1010/15/2469692989739603/creation-01/video.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIRRHGJ67R2DBRIAO%2F20240111%2Fcn-northwest-1%2Fs3%2Faws4_request&X-Amz-Date=202401101105370287&X-Amz-Expires=86400&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3Bfilename%3D%22vidu-high-performance-general-4-2024-10-10T15%2B34%2B33Z3.mp4%22&X-Amz-Signature=1f5c5759329a655a856a768d6dbcbcb7cb4715a036ab7e60a92885375ac342",
      "cover_url": "https://dev-ss-vidu.s3.cn-northwest-1.amazonaws.com.cn/infer/tasks/24/1010/15/2469692989739603/creation-01/cover.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIRRHGJ67R2DBRIAO%2F20240111%2Fcn-northwest-1%2Fs3%2Faws4_request&X-Amz-Date=202401101105370287&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&x-id=GetObject&X-Amz-Signature=219bc92894476cb2635aa35d56ebcddb3a37d99731a5740c1faa3185ccb36652"
    }
  ]
}

创建任务示例

Text2Video

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "type": "text2video",
    "model": "vidu-high-performance",
    "style": "general",
    "input":{
        "seed": 123,
        "enhance": true,
        "prompts":[{
            "type":"text",
            "content":"小白兔白又白"
        }]
    },
    "output_params":{
        "sample_count":1,
        "duration": 4
    }
}' https://bdttv.exp.bcevod.com/ent/v1/tasks

Image2video

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "type": "img2video",
    "model": "vidu-high-performance",
    "input":{
        "enhance": true,
        "prompts":[{
            "type":"text",
            "content":"向日葵动起来"
        },{
        "type":"image",
        "content":"https://pic.netbian.com/uploads/allimg/170624/172231-1498296151ea67.jpg"
        }]
    },
    "output_params":{
        "sample_count":1,
        "duration": 4
    }
}' https://bdttv.exp.bcevod.com/ent/v1/tasks

Image2video / model v1.5

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "type": "img2video",
    "model_version":"1.5",
    "input":{
        "prompts":[{
            "type":"text",
            "content":"向日葵在可口可乐中游泳"
        },{
            "type":"image",
            "content":"https://pic.netbian.com/uploads/allimg/170624/172231-1498296151ea67.jpg"
        }]
    },
    "output_params":{
        "sample_count":1,
        "resolution": "512",
        "movement_amplitude": "auto",
        "duration": 4
    }
}' https://bdttv.exp.bcevod.com/ent/v1/tasks

HeadTailimg2video

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "type": "headtailimg2video",
        "model_version":"1.5",
    "input":{
        "prompts":[{
            "type":"text",
            "content":"向日葵在可口可乐中游泳"
        },{ // first image
            "type":"image",
            "content":"https://pic.netbian.com/uploads/allimg/170624/172231-1498296151ea67.jpg"
        },{ // last image
            "type":"image",
            "content":"https://pic.netbian.com/uploads/allimg/170624/172231-1498296151ea67.jpg"
        }]
    },
    "output_params":{
        "sample_count":1,
        "resolution": "512",
        "movement_amplitude": "auto",
        "duration": 4
    }
}' https://bdttv.exp.bcevod.com/ent/v1/tasks

Character2video

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "type": "character2video",
      "model": "vidu-high-performance",
    "input":{
        "enhance": true,
        "prompts":[{
            "type":"text",
            "content":"向日葵在可口可乐中游泳"
        },{
        "type":"image",
        "content":"https://pic.netbian.com/uploads/allimg/170624/172231-1498296151ea67.jpg"
        }]
    },
    "output_params":{
        "sample_count":1,
        "duration": 4
    }
}' https://bdttv.exp.bcevod.com/ent/v1/tasks

Character2video / model v1.5

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "type": "character2video",
    "model_version": "1.5",
    "input": {
        "enhance": true,
        "multi_image_boost": true,
        "prompts": [
            {
                "type": "text",
                "content": "女孩的手心漂浮着一只半透明金鱼，镜头逐渐拉近，镜头顺时针旋转"
            },
            {
                "type": "image",
                "content": "https://dev-ss-images.s3.cn-northwest-1.amazonaws.com.cn/tmp/2024"
            },
            {
                "type": "image",
                "content": "https://dev-ss-images.s3.cn-northwest-1.amazonaws.com.cn/tmp/2024"
            },
            {
                "type": "image",
                "content": "https://dev-ss-images.s3.cn-northwest-1.amazonaws.com.cn/tmp/2024"
            }
        ]
    },
    "output_params": {
        "sample_count": 1,
        "resolution": "720p",
        "duration": 4,
        "aspect_ratio": "1:1",
        "movement_amplitude": "auto"
    }
}
' https://bdttv.exp.bcevod.com/ent/v1/tasks

Upscale

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "type": "upscale",
    "model": "stable",
    "input":{
        "creation_id": 2421167565532164 // 从 GetTaskCreations 接口获取
    },
    "output_params":{
        "sample_count":1,
        "duration": 4
    }
}' https://bdttv.exp.bcevod.com/ent/v1/tasks

Scene

拥抱

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "scene": "hug",
    "input":{
        "prompts":[{
            "type": "text",
            "content": "拥抱"
        },
        {
            "type":"image",
            "content":"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu/example/20241206-180307.jpeg"
        }]
    }
}' https://bdttv.exp.bcevod.com/ent/v1/scenes/tasks

亲吻

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "scene": "kiss",
    "input":{
        "prompts":[{
            "type": "text",
            "content": "亲吻"
        },
        {
            "type":"image",
            "content":"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu/example/20241206-180307.jpeg"
        }]
    }
}' https://bdttv.exp.bcevod.com/ent/v1/scenes/tasks

圣诞特效

变身为圣诞老人

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "scene": "christmas",
    "input":{
        "prompts":[{
            "type": "text",
            "content": "视频内容\\n画面中的人物从下前方轻轻举起鲜红的布，动作干净利落地将其从头覆盖到全身，然后随着人物将红布迅速向下扯下，人物变成了充满节日气息的圣诞老人。\\n# 要求\\n1.Style设定为:Realistic, HD\\n2.根据用户上传图片确定人物数量，不要出现[一群人]、[们]等代词而是精准地指出人物数量\\n3.如果用户上传图片有多个人物，则他们需要一起举起红布，所有人都变身为圣诞老人。不要出现图片中没有的人物"
        },
        {
            "type":"image",
            "content":"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu/example/20241206-181200.png"
        }]
    }
}' https://bdttv.exp.bcevod.com/ent/v1/scenes/tasks

圣诞老人来送礼

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "scene": "christmas",
    "input":{
        "prompts":[{
            "type": "text",
            "content": "视频内容\\n镜头中人物看向右边，然后一个圣诞老人满面笑容地从右边走入画面，手中捧着一个精美的礼物盒。他轻轻将礼物递给画面中的人物，动作自然且充满温暖。镜头聚焦在接到礼物的人物，人物神情中充满惊喜与感激。画面捕捉到人物的微表情和互动细节。\\n# 要求\\n1.Style设定为:Realistic, HD\\n2.根据用户上传图片确定人物数量，不要出现[一群人]、[们]等代词而是精准地指出人物数量\\n3.如果用户上传图片有多个人物，则他们需要一起举起红布，所有人都变身为圣诞老人。不要出现图片中没有的人物"
        },
        {
            "type":"image",
            "content":"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu/example/20241206-175539.jpeg"
        }]
    }
}' https://bdttv.exp.bcevod.com/ent/v1/scenes/tasks

圣诞节举杯庆祝

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "scene": "christmas",
    "input":{
        "prompts":[{
            "type": "text",
            "content": "视频内容\\n画面人物手里拿起香槟酒杯，庆祝圣诞快乐，随着镜头拉远，画面出现圣诞树等圣诞节日物品\\n# 要求\\n1.Take a step-by-step approach in your response\\n2.以我的视频描述为第一要素，背景的描述统一、合理，不要描述两次.\\n3.根据用户上传图片确定人物数量，不要出现[一群人]、[们]等代词而是精准地指出人物数量\\n4.Motion Level 设定为：Middle\\n5.如果用户上传图片有多个人物，每个人都需要拿起香槟酒杯。不要出现图片中没有的人物"
        },
        {
            "type":"image",
            "content":"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu/example/20241206-175551.jpeg"
        }]
    }
}' https://bdttv.exp.bcevod.com/ent/v1/scenes/tasks

圣诞老人来拥抱

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "scene": "christmas",
    "input":{
        "prompts":[{
            "type": "text",
            "content": "视频内容\\n镜头中人物看向画面外，接着一个圣诞老人满面笑容地从画面外走入画面，然后和人物拥抱，动作自然且充满温暖，镜头聚焦在一个温暖的拥抱，画面捕捉到人物的的微表情和互动细节\\n# 要求\\n1.根据人物的位置和状态合理的设计动作，而不是突兀的直接拥抱，要先描写人物转变到一个合适拥抱的姿势\\n2.Take a step-by-step approach in your response\\n3.根据用户上传图片确定人物数量，不要出现[一群人]、[们]等代词而是精准地指出人物数量\\n4.如果图片中有多个人物，则需要一起和圣诞老人拥抱。不要出现图片中没有的人物\\n5.强调只有1个圣诞老人"
        },
        {
            "type":"image",
            "content":"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu/example/20241206-175551.jpeg"
        }]
    }
}' https://bdttv.exp.bcevod.com/ent/v1/scenes/tasks

变形特效

膨胀

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "scene": "morphlab",
    "input":{
        "prompts":[{
            "type": "text",
            "content": "视频内容\\n画面中主体开始膨胀变形，变得越来越大，越来越圆，就像一个气球，慢慢飘了起来\\n# 要求\\n1.根据用户上传图片确定主体数量,每个主体都要膨胀\\n2.Motion Level 设定为:Middle\\n3.以我的视频内容为第一要素，背景的描述统一、合理，不要描述两次."
        },
        {
            "type":"image",
            "content":"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu/example/20241206-175605.jpeg"
        }]
    }
}' https://bdttv.exp.bcevod.com/ent/v1/scenes/tasks

捏捏

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "scene": "morphlab",
    "input":{
        "prompts":[{
            "type": "text",
            "content": "视频内容\\n画面开始，主体静止不动。随后，一双大手出现，将主体像橡皮泥般抓住并挤压。\\n随着主体逐渐缩小，被夹在手指间柔软变形\\n# 要求\\n1.根据用户上传图片确定主体数量,每个主体都要被捏扁\\n2.Motion Level 设定为:Middle\\n3.以我的视频内容为第一要素，背景的描述统一、合理，不要描述两次."
        },
        {
            "type":"image",
            "content":"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu/example/20241206-175605.jpeg"
        }]
    }
}' https://bdttv.exp.bcevod.com/ent/v1/scenes/tasks

爆炸

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "scene": "morphlab",
    "input":{
        "prompts":[{
            "type": "text",
            "content": "视频内容\\n画面开始主体突然爆炸，细碎的颗粒爆炸开来\\n# 要求\\n1.根据用户上传图片确定主体数量,每个主体都要爆炸\\n2.Motion Level 设定为:Middle\\n3.以我的视频内容为第一要素，背景的描述统一、合理，不要描述两次."
        },
        {
            "type":"image",
            "content":"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu/example/20241206-175531.jpeg"
        }]
    }
}' https://bdttv.exp.bcevod.com/ent/v1/scenes/tasks

融化

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "scene": "morphlab",
    "input":{
        "prompts":[{
            "type": "text",
            "content": "视频内容\\n画面中主体慢慢地开始融化，最终形成一个表面光滑的水坑\\n# 要求\\n1.根据用户上传图片确定主体数量,每个主体都要融化\\n2.Motion Level 设定为:Middle\\n3.以我的视频内容为第一要素，背景的描述统一、合理，不要描述两次."
        },
        {
            "type":"image",
            "content":"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu/example/20241206-181156.png"
        }]
    }
}' https://bdttv.exp.bcevod.com/ent/v1/scenes/tasks

实况照片

甜美微笑

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "scene": "live_photo",
    "input":{
        "prompts":[{
            "type": "text",
            "content": "主体面对镜头，露出了甜美动人的微笑"
        },
        {
            "type":"image",
            "content":"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu/example/%E7%94%9C%E7%BE%8E%E5%BE%AE%E7%AC%91.png"
        }]
    }
}' https://bdttv.exp.bcevod.com/ent/v1/scenes/tasks

风动

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "scene": "live_photo",
    "input":{
        "prompts":[{
            "type": "text",
            "content": "主体头发丝被风朝着某一个方向微微吹动"
        },
        {
            "type":"image",
            "content":"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu/example/%E9%A3%8E%E5%8A%A8.png"
        }]
    }
}' https://bdttv.exp.bcevod.com/ent/v1/scenes/tasks

镜头动

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "scene": "live_photo",
    "input":{
        "prompts":[{
            "type": "text",
            "content": "镜头缓缓拉近,风轻轻吹着主体"
        },
        {
            "type":"image",
            "content":"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu/example/%E9%95%9C%E5%A4%B4%E5%8A%A8.png"
        }]
    }
}' https://bdttv.exp.bcevod.com/ent/v1/scenes/tasks

走路

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "scene": "live_photo",
    "input":{
        "prompts":[{
            "type": "text",
            "content": "视频内容\\n画面主体，正对镜头走模特步\\n# 要求\\n1.根据img图片人物状态，设计合适的镜头运动，镜头应该慢慢转变为中景或者牛仔镜头【拉远或者推进】能够显露出人物的大半个身体\\n2.根据img图片人物状态，设计合理的动作转变，最终人物应当面对镜头走模特步\\n3.严格根据图片确定人物外观，不要出现图片没有的人物"
        },
        {
            "type":"image",
            "content":"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu/example/%E8%B5%B0%E8%B7%AF.png"
        }]
    }
}' https://bdttv.exp.bcevod.com/ent/v1/scenes/tasks

情绪特效

恐惧

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "scene": "emotionlab",
    "input":{
        "prompts":[{
            "type": "text",
            "content": "视频内容\\n画面主体的表情开始慢慢变化，变得恐惧害怕，眼神里满是无助和惊慌，害怕的大声尖叫\\n# 要求\\n1.根据用户上传图片确定主体数量、人物性别、shot_size,每个主体都是同样的表情变化\\n2.Motion Level 设定为:Middle\\n3.以我的视频内容为第一要素，背景和图片保持一致，不要变化，不要描述两次\\n4.镜头固定不要移动"
        },
        {
            "type":"image",
            "content":"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu/example/%E6%81%90%E6%83%A7.jpeg"
        }]
    }
}' https://bdttv.exp.bcevod.com/ent/v1/scenes/tasks

惊讶

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "scene": "emotionlab",
    "input":{
        "prompts":[{
            "type": "text",
            "content": "视频内容\\n图中的人物逐渐露出特别惊讶的表情，眼睛睁大，嘴巴微微张开，透出难以置信的神情。\\n# 要求\\n1.根据用户上传图片确定主体数量、人物性别、shot_size,每个主体都是同样的表情变化\\n2.Motion Level 设定为:Middle\\n3.以我的视频内容为第一要素，背景的描述统一、合理，不要描述两次\\n4.镜头固定不要移动,人物主要是表情变化，人物表情变化要自然"
        },
        {
            "type":"image",
            "content":"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu/example/%E6%83%8A%E8%AE%B6.jpeg"
        }]
    }
}' https://bdttv.exp.bcevod.com/ent/v1/scenes/tasks

微笑

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "scene": "emotionlab",
    "input":{
        "prompts":[{
            "type": "text",
            "content": "视频内容\\n画面主体的表情开始慢慢变化,表情逐渐放松，嘴角轻轻上扬，眼神变得柔和，微笑逐渐展现出温和与宁静的氛围。\\n# 要求\\n1.根据用户上传图片确定主体数量、人物性别、shot_size,每个主体都是同样的表情变化\\n2.Motion Level 设定为:Middle\\n3.以我的视频内容为第一要素，背景的描述统一、合理，不要描述两次\\n4.镜头固定不要移动\\n5.根据人物初始状态选择比较微小的微笑，还是比较开朗的微笑.不要过于夸张的微笑"
        },
        {
            "type":"image",
            "content":"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu/example/%E5%BE%AE%E7%AC%91.jpeg"
        }]
    }
}' https://bdttv.exp.bcevod.com/ent/v1/scenes/tasks

狂笑

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "scene": "emotionlab",
    "input":{
        "prompts":[{
            "type": "text",
            "content": "视频内容\\n画面主体的表情开始慢慢变化,随着心情的放松，眉头慢慢舒展，嘴角开始上扬。然后他的笑容逐渐扩大，眼睛也变得更加明亮，仿佛看到了什么有趣的事物。最终，他大笑起来，嘴巴张得大大的，露出洁白的牙齿，动作夸张\\n# 要求\\n1.根据用户上传图片确定主体数量、人物性别、shot_size,每个主体都是同样的表情变化\\n2.Motion Level 设定为:Middle\\n3.以我的视频内容为第一要素，背景的描述统一、合理，不要描述两次\\n4.镜头固定不要移动,人物表情变化要自然"
        },
        {
            "type":"image",
            "content":"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu/example/%E7%8B%82%E7%AC%91.jpeg"
        }]
    }
}' https://bdttv.exp.bcevod.com/ent/v1/scenes/tasks

复活老照片

curl -X POST -H "Authorization: Basic {token}" -H "Content-Type: application/json" -d '
{
    "scene": "live_memory",
    "input":{
        "prompts":[{
            "type": "text",
            "content": "视频内容\\n视频中的人物们，简单互动，微笑看着屏幕\\n# 要求\\n1.严格根据图片判断有多少个人物，精准简要的描述人物外观\\n2.Motion Level ：Small"
        },
        {
            "type":"image",
            "content":"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu/example/%E5%A4%8D%E6%B4%BB%E8%80%81%E7%85%A7.jpeg"
        }]
    }
}' https://bdttv.exp.bcevod.com/ent/v1/scenes/tasks

查询任务示例

GetTaskState

curl -H "Authorization: Basic {token}" -H "Content-Type: application/json" https://bdttv.exp.bcevod.com/ent/v1/tasks/{task_id}/creations

数据结构

播放器SDK

智能点播平台 VOD

视频生成接口文档

Endpoints

API 常见报错信息

创建任务接口支持模型

创建场景任务接口支持场景

API 认证方式

Basic Authentication

接口

创建任务接口

请求方式

请求头

请求体

响应体

响应示例

创建场景任务接口

请求方式

请求头

请求体

响应体

查询任务接口

请求方式

请求头

请求参数

响应体

响应示例

创建任务示例

Text2Video

Image2video

Image2video / model v1.5

HeadTailimg2video

Character2video

Character2video / model v1.5

Upscale

Scene

拥抱

亲吻

圣诞特效

变形特效

实况照片

情绪特效

复活老照片

查询任务示例

GetTaskState