图文生成视频

更新时间：2022-04-28

各接口用途说明

图文生成视频涉及4个接口，分别为：网页转视频、图文素材转视频、视频任务查询、视频任务中止与删除。

创建视频任务涉及两个接口，您可根据需求选择不同的接口进行视频任务的创建；视频创建后，您可通过视频任务查询接口查看视频生成结果；若您不需要该视频，可以使用视频任务中止与删除接口进行删除操作。

网页转视频：传入图文的url，创建视频任务。
图文素材转视频：传入字幕、图片等素材，创建视频任务。
视频任务查询：用于在视频任务创建后，查看视频生成状态。待视频生成完毕，通过查询接口即可查看生成视频的地址链接。
视频任务中止与删除：用于在视频任务创建后，中止并删除视频。

创建网页转视频

接口描述

用于创建图文生成视频任务，提供新闻链接和必要的参数，即可创建一个视频任务，得到任务id，用于后续的查询或中止操作。

请求说明

请求示例

HTTP方法: POST
请求URL: https://aip.baidubce.com/rpc/2.0/brain/vidpress/v1/create_vidpress
URL参数：

参数	值
access_token	通过API Key和Secret Key获取的access_token，参考“Access Token获取”

Header如下：

参数	值
Content-Type	application/json

body请求参数:

参数	是否必选	类型	描述
newsUrl	是	string	网页地址链接
ttsPer	是	int	发音人，支持范围如下。0:成熟女声;1:温润男声、3:磁性男声、4:乖巧女童、100:甜美女生、103:可爱女生、106:成熟男声
duration	是	int	目标视频时长 30-300s
resolution	是	string	尺寸分辨率，360 <= 宽度 <= 1920,360 <= 高度 <= 1920 推荐使用1280x720以下分辨率,分辨率越高,需要生成的时间就越多。
videoBegin	否	string	片头视频地址
videoBeginDuration	否	float	可限制片头视频的时长，单位：秒（对片头视频做截断操作）
videoEnd	否	string	片尾视频地址，不需片尾时长
videoLogo	否	string	角标链接
videoLogoMargin	否	int	角标边缘距离，可选参数，默认为 0。会同时指定上方和左右的距离（传参示例：20）
videoLogoPos	否	string	角标位置，可选参数，支持左上角（top- left）、右上角（top-right）。默认为 top-left
bgMusic	否	string	背景音乐链接
captionBottomMargin	否	int	字幕位置，距离视频底部的位置，单位px，如：10。字幕背景默认为黑色。

Body示例

 {
    "newsUrl":" ",
    "duration":60,
    "resolution":"1280x720",
    "ttsPer":106
}

返回说明

返回参数

参数	类型	详细说明
code	int	错误码，0代表成功，其他代表失败
msg	string	错误信息，成功时为空，失败返回错误原因
data	array	成功时，返回的结果数组
+jobId	int	任务id，用于后续查询或中止任务
+estimateStartTime	datetime	任务预计开始时间
+estimateFinishTime	datetime	任务预计结束时间

返回示例

成功返回示例：

{
    "code": 0,
	 "data": {
	    "jobId": 111,
	    "estimateStartTime": "2020-01-07 12:00:00",
	    "estimateFinishTime": "2020-01-07 12:30:00"
	    },
	  "msg": "success"
}

失败返回示例：

{
    "code": 84001,
    "msg": "已有任务正在生成视频, 任务完成后可再次创建!",
}

创建图文素材转视频

接口描述

用于创建图文生成视频任务，提供素材（文本、图片素材等）信息作为参数，即可创建一个视频任务，得到任务 id，用于后续的查询或中止操作，支持多段图文组合。

请求说明

请求示例

HTTP方法: POST
请求URL: https://aip.baidubce.com/rpc/2.0/brain/vidpress/v1/create_vidpress_alignment
URL参数：

参数	值
access_token	通过API Key和Secret Key获取的access_token，参考“Access Token获取”

Header如下：

参数	值
Content-Type	application/json

body请求参数:

参数	是否必选	类型	描述
trackTexts	是	array	图文信息
+TrackText.text	是	string	原始文章内容 3000 字以内
+TrackText.tracks	是	Array	图片素材数组，总时长范围 10-300s
+Track.url	是	string	图片素材地址
+Track.expectedDuration	否	float	图片素材播放时长，单位：秒
+Track.type	是	string	素材类型，图片为“image” ，支持JPEG/JPG/PNG/GIF类型的图片
totalDuration	是	int	素材总时长，单位：秒。若传入，以此值为准，范围为 10-300 秒
resolution	是	string	尺寸分辨率，360 <=宽度 <= 1920，360 <= 高度 <= 1920 推荐使用1280x720以下分辨率,分辨率越高,需要生成的时间就越多
ttsPer	是	int	发音人，支持的范围如下：1:温润男声、3:磁性男声、106:成熟男声、0:成熟女声、100:甜美女生、4:乖巧女童、103:可爱女生
videoTitle	是	string	视频标题
videoBegin	否	string	片头视频地址
videoBeginDuration	否	float	可限制片头视频的时长，单位：秒（对片头视频做截断操作）
videoEnd	否	string	片尾视频地址，暂不需片尾时长
videoLogo	否	string	角标链接
videoLogoMargin	否	int	角标边缘距离，可选参数，默认为 0。会同时指定上方和左右的距离（传参示例：20）
videoLogoPos	否	string	角标位置，可选参数，支持左上角（top-left）、右上角（top-right）。默认为 top-left
bgMusic	否	string	背景音乐链接
captionBottomMargin	否	int	字幕位置，距离视频底部的位置，单位px，例如：10。字幕背景默认为黑色。

Body示例

{
	"totalDuration": 60,
	"resolution": "1280x720",
	"trackTexts": [
	{
        	"text": "今日，人社部举行2022年一季度新闻发布会。会上，人力资源社会保障部就业促进司副司长陈勇嘉介绍，为进一步提升毕业生就业服务质量，促进他们顺利就业，今年3月—6月，人社部组织开展“公共就业服务进校园”活动，活动开展以来各地共组织各类活动1万余场，提供岗位信息近500万个，服务毕业生近600万人次。",
	        "tracks": [
	        {
                "expectedDuration": 10,
	              "type": "image",
	              "url": "https://pics3.baidu.com/feed/9f510fb30f2442a73a14b6cd99119241d1130218.jpeg?token=82ebd16ec1a8e83328ed87290770cd26"
	        }
	       ]
    }
	],
	"videoTitle":"test",
    "ttsPer": 0
 }

返回说明

返回参数

参数	类型	详细说明
code	int	错误码，0 代表成功，其他代表失败
msg	string	错误信息，成功时返回success，失败返回错误原因
data	array	成功时，返回结果数组
+jobId	int	任务 id，用于后续查询或中止任务
+estimateStartTime	datetime	任务预计开始时间
+estimateFinishTime	datetime	任务预计结束时间

返回示例

{
    "code": 0,
	 "data": {
	    "jobId": 111,
	    "estimateStartTime": "2020-01-07 12:00:00",
	    "estimateFinishTime": "2020-01-07 12:30:00"
	    },
	  "msg": "success"
}

错误码详见错误码列表

视频任务查询

接口描述

用于查询视频任务列表信息，或某个任务 id 的当前信息。

请求说明

请求示例

HTTP方法: POST
请求URL: https://aip.baidubce.com/rpc/2.0/brain/vidpress/v1/query
URL参数：

参数	值
access_token	通过API Key和Secret Key获取的access_token，参考“Access Token获取”

Header如下：

参数	值
Content-Type	application/json

body请求参数:

参数	是否必选	类型	描述
jobId	是	int	创建接口返回的任务id

Body示例

 {
    "jobId": 111
 }

返回说明

返回参数

参数	类型	详细说明
code	int	错误码，0代表成功，其他代表失败
msg	string	错误信息
data	Object	查询结果
+ jobId	int	任务 id
+ status	int	任务状态 3:生成中,4:生成成功,5:生成失败，100:已删除
成功时的data参数
+ expireTime	Date	视频文件过期时间
+ expire	int	是否失效，1：已失效，2：未失效
+ videoAddr	string	视频地址
+ videoDuration	int	结果视频时长
失败时的data参数
+ failReason	string	失败原因
生成中/排队中的data参数
+ estimateStartTime	date	任务开始时间
+ estimateFinishTime	date	任务结束时间

返回示例

成功返回示例

    {
        "code": 0,
        "msg": "success",
        "data": {
            "jobId": 123,
            "status": 4,
            "expireTime": "2020-01-20 19:35:37",
            "expire": 2,
            "videoAddr": "http://bj.bcebos.com/nlpc-article-outer-
            vidpress/3_d3b5ab1fb988cc19ef99d5b3d1ba17ee.mp4",
            "videoCoverAddr": "http://bj.bcebos.com/nlpc-article-outer-
            vidpress/3_8d87d78ace2de50ae3d8d9059eeb5d51.jpeg",
            "videoDuration": "110"
        }
    }

失败返回示例

	{
        "code": 0,
        "msg": "success",
        "data": {
            "jobId": 123,
            "status": 5,
            "failReson": "网络原因"
	    }
	}

生成中返回示例

	{
        "code": 0,
        "msg": "success",
        "data": {
            "jobId": 123,
            "status": 3,
            "estimateStartTime": "2020-12-12 00:00:00",
            "estimateFinishTime": "2020-12-12 00:00:00"
	    }
	}

视频任务中止与删除

接口描述

用于中止或删除已有的视频任务。

请求说明

请求示例

HTTP方法: POST
请求URL: https://aip.baidubce.com/rpc/2.0/brain/vidpress/v1/delete
URL参数：

参数	值
access_token	通过API Key和Secret Key获取的access_token，参考“Access Token获取”

Header如下：

参数	值
Content-Type	application/json

body请求参数:

参数	是否必选	类型	描述
jobId	是	int	任务id

Body示例

 {
    "jobId": 111
 }

返回说明

返回参数

参数	类型	详细说明
code	int	状态码
msg	string	错误信息

返回示例

成功返回示例

{
	"code": 0,
	"msg": "ok"
}

错误码

错误码	错误信息
84001	创建视频生成任务失败, 请稍后重试! 已有任务正在生成视频, 任务完成后可再次创建!
84002	创建视频生成任务失败, 请更换URL链接后再试!
84003	查询视频生成任务失败, 请稍后重试! 任务不存在, 请检查输入数据后再试!
84005	删除视频生成任务失败, 请稍后重试! 任务不存在, 请检查输入数据后再试!

资讯地域识别

常见问题及排查

百度智能云

语言与知识

语言与知识

图文生成视频

各接口用途说明

创建网页转视频

接口描述

请求说明

Body示例

返回说明

返回示例

创建图文素材转视频

接口描述

请求说明

Body示例

返回说明

返回示例

视频任务查询

接口描述

请求说明

Body示例

返回说明

返回示例

视频任务中止与删除

接口描述

请求说明

Body示例

返回说明

返回示例