输入首帧图片以及对应的模版名称,生成视频;
Hi,您好,欢迎使用有道智云“文生视频”接口服务。
本文档主要针对需要集成HTTP API的技术开发工程师,详细描述接口计费,入参,返回值等信息。
如果您有与我们商务合作的需求,可以通过以下方式联系我们:
商务邮箱: AIcloud_Business@corp.youdao.com
如果您对文档内容有任何疑问,可以通过以下几种方式联系我们:
客服QQ:1906538062
AIGC产品技术交流群 :837394306
联系邮箱: zhiyun@corp.youdao.com
温馨提示:
调用方在集成本接口时,请遵循以下规则。
规则 | 描述 |
---|---|
传输方式 | 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 --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 --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"
}'
状态码 | 状态码含义 |
---|---|
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 | 模版生视频服务异常 |
暂无
暂无
暂无