外观
视频生视频简介
概念解释
提供一个视频链接，基于此视频生成一个高清的视频
说明
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/video2video
请求参数
| 参数名称 | 类型 | 含义 | 是否必填 | 示例或描述 |
|---|---|---|---|---|
| appKey | string | 应用ID | 是 | |
| salt | string | 随机值 | 是 | |
| curtime | string | 时间戳（单位到秒） | 是 | 1757560399 |
| sign | string | 签名 | 是 | 参见下方的签名生成方法 |
| videoUrl | string | 原始视频 URL 地址 | 是 | 视频长度不超多30秒，大小不超过 500M |
| resolution | string | 目标输出分辨率，默认值为 1080p。- 可选值包括：1080p、2K、4K、8K。- 设置的清晰度必须高于原视频分辨率，否则任务将返回失败。 | 否 |
签名生成方法如下(v3)：
sign=sha256(appKey+input+salt+curtime+应用密钥)；
其中，
1. 当 videoUrl 长度小于等于20时，input=videoUrl；
2. 当 videoUrl 长度大于20时，input=videoUrl 前10个字符 + videoUrl 长度 + videoUrl 后10个字符；响应结果
| 字段 | 类型 | 含义 |
|---|---|---|
| code | String | 错误码 |
| msg | String | 错误信息 |
| data | Object | 数据 |
| data.taskId | String | 任务ID |
| data.state | String | 任务状态 |
| data.price | String | 本次任务的价格，单位：元 |
| data.model | String | 使用的模型，参见请求参数中的 model |
| data.prompt | String | 参见请求参数中的 prompt |
| 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 示例
bash
curl --location --request POST 'https://openapi.youdao.com/proxy/http/video2video' \
--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": "1758458368",
"sign": "5a94228f288a2298b85b779ae478e622f0449b72c1bff185d36a3137a59022d4",
"videoUrl": "https://download.ydstatic.com/zhiyun/%E6%83%85%E4%BE%A3%E9%80%81%E8%8A%B1.mp4",
"resolution": "2K"
}'任务状态查询接口：
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 示例
bash
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 示例
暂无