帮助与文档 > 产品文档 > AIGC > API文档 > 模板生视频
模板生视频

模版生视频简介

概念解释

输入首帧图片以及对应的模版名称,生成视频;

说明

Hi,您好,欢迎使用有道智云“文生视频”接口服务。

本文档主要针对需要集成HTTP API的技术开发工程师,详细描述接口计费,入参,返回值等信息。

如果您有与我们商务合作的需求,可以通过以下方式联系我们:

商务邮箱: AIcloud_Business@corp.youdao.com

如果您对文档内容有任何疑问,可以通过以下几种方式联系我们:

客服QQ:1906538062

AIGC产品技术交流群 :837394306

联系邮箱: zhiyun@corp.youdao.com

温馨提示:

  • 本文档主要针对开发人员,接入测试前需要获取应用ID和应用密钥,并创建应用;如果您还没有,请按照 新手指南 获取。
  • 平台向每个账户赠送50元的体验金,供用户集成前测试所用。

协议须知

调用方在集成本接口时,请遵循以下规则。

规则 描述
传输方式 HTTPS
请求方式 POST
字符编码 统一使用UTF-8 编码
请求格式 application/json
响应格式 JSON

接口定义

任务提交接口:

https://openapi.youdao.com/proxy/http/template2video

请求参数

参数名称 类型 含义 是否必填 示例或描述
appKey string 应用ID
salt string 随机值
curtime string 时间戳(单位到秒) 1757560399
sign string 签名 参见下方的签名生成方法
images String[] 图片数组,每张图片支持 base64 编码(不超过10M)或 URL 地址 base64编码要求添加前缀,例如: data:image/jpeg;<base64内容>
template string 参见下方模版名称列表
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
bgm boolean 是否为生成的视频添加背景音乐 -- 默认:false,可选值 true 、false
传 true 时系统将从预设 BGM 库中自动挑选合适的音乐;
BGM不限制时长,系统根据视频时长自动适配
watermark boolean 是否添加水印 -- true, false(默认) 目前水印内容为固定,内容由AI生成,默认不加

签名生成方法如下(v3):

sign=sha256(appKey+input+salt+curtime+应用密钥);
其中,
1. 当 prompt 长度小于等于20时,input=prompt;
2. 当 prompt 长度大于20时,input=prompt前10个字符 + prompt长度 + prompt后10个字符;

响应结果

字段 类型 含义
code String 错误码
msg String 错误信息
data Object 数据
data.taskId String 任务ID
data.state String 任务状态
data.price String 本次任务的价格,单位:元
data.duration int 参见对应的请求参数
data.seed int 参见对应的请求参数
data.aspectRatio String 参见对应的请求参数
data.resolution String 参见对应的请求参数
data.bgm boolean 参见对应的请求参数
data.movementAmplitude String 参见对应的请求参数
data.watermark boolean 参见对应的请求参数
data.createAt String 任务创建时间

curl 示例

curl --location --request POST 'https://openapi.youdao.com/proxy/http/image2video' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--header 'Accept: */*' \
--header 'Host: openapi.youdao.com' \
--header 'Connection: keep-alive' \
--header 'Content-Type: application/json' \
--data-raw '{
  "appKey": "<YourAppKey>",
  "salt": "09d703a3-e79d-41b9-ab92-2a19f9426cec",
  "curtime": "1758462568",
  "sign": "2a1fb0083888b7bea9a39e272181ea799eeb05b3677e4e68f70b23e42d1bd919",
  "template": "yd_werewolf_trans",
  "images": [
    "https://mock.youdao.com/1.jpg"
  ]
}'

任务状态查询接口:

https://openapi.youdao.com/proxy/http/video-task-state

请求参数

参数名称 类型 含义 是否必填 示例或描述
appKey string 应用ID
salt string 随机值
curtime string 时间戳(单位到秒) 1757560399
sign string 签名 参见下方的签名生成方法
taskId string 任务ID 863277121131298816

签名生成方法如下(v4):

sign=sha256(appKey+salt+curtime+应用密钥);

响应结果

字段 类型 含义
code String 错误码
msg String 错误信息
data Object 数据
data.taskId String 任务ID
data.state String 任务状态 -- created,queueing, processing, success, failed, not_found, sensitive
data.errorCode String 对应当前状态的错误码
data.videoUrls String[] 生成物地址,一个小时有效期
data.coverUrls String[] 生成物封面地址,一个小时有效期

curl 示例

curl --location --request POST 'https://openapi.youdao.com/proxy/http/video-task-state' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--header 'Accept: */*' \
--header 'Host: openapi.youdao.com' \
--header 'Connection: keep-alive' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appKey": "<YourAppKey>",
    "salt": "09d703a3-e79d-41b9-ab92-2a19f9426cec",
    "curtime": "1758461459",
    "sign": "1e97a1eb0e7f2343d129c32841f5927a8a66e16b258759226abd62cda2dc823c",
    "taskId": "d-ydt-564615369830444990"
}'

API错误代码列表

状态码 状态码含义
0 成功
1 未知错误,请联系客服
101 缺少必填的参数,首先确保必填参数齐全,然后,确认参数书写是否正确。
108 应用ID无效,注册账号,登录后台创建应用并完成绑定,可获得应用ID和应用密钥等信息
110 当前应用ID没有权限访问此服务,需要在控制台给当前应用ID开通此服务
112 请求的服务不存在
202 签名检验失败
206 因为时间戳无效导致签名校验失败
207 重放请求
900000 当前对应服务配置有误,请联系客服
900001 并发量过高,请稍后重试
901000 认证服务异常
901001 未找到匹配的计费方案
901002 限流服务异常
901003 没有找到匹配的价格方案
901004 当前模版不支持,请联系客服
901050 没有足够的余额
901051 计费日志异常,请联系客服
901052 扣减余额失败,请联系客服
904001 查询视频生成任务状态异常
904002 未找到视频生成任务
905000 文生视频服务异常
905100 图生视频服务异常
905200 模版生视频服务异常

常用语言 Demo

Java 示例

暂无

python3 示例

暂无

go 示例

暂无