开放能力
开发平台
行业应用
生态合作
开发与教学
资讯 社区 控制台
技术能力
语音技术
文字识别
人脸与人体
图像技术
语言与知识
视频技术
AR与VR
数据智能
场景方案
部署方案
行业应用
智能教育
智能医疗
智能零售
智能工业
企业服务
智能政务
信息服务
智能园区

图文生成视频

各接口用途说明

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

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

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

创建网页转视频

接口描述

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

请求说明

请求示例

参数
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,用于后续的查询或中止操作,支持多段图文组合。

请求说明

请求示例

参数
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 的当前信息。

请求说明

请求示例

参数
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"
	    }
	}

视频任务中止与删除

接口描述

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

请求说明

请求示例

参数
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 删除视频生成任务失败, 请稍后重试! 任务不存在, 请检查输入数据后再试!
上一篇
资讯地域识别
下一篇
常见问题及排查