Vidu 系列模型接入

概览

OneLinkAI 提供 Vidu 平台兼容接口，用于在 OneLinkAI 网关下调用 Vidu 相关能力。整体目标是尽可能兼容 Vidu 官方协议，方便已经接入 Vidu 官方接口的业务快速迁移或并行接入。

当前这组兼容接口的基本原则如下：

请求参数尽可能对标 Vidu 官方接口。

路径在官方接口基础上统一增加 /vidu 前缀。

创建类接口通常返回 task_id。

任务创建成功后，建议通过查询生成物接口获取结果。

具体兼容差异请以各接口文档中的请求示例、响应示例和字段定义为准。

接入规则

鉴权方式

调用 OneLinkAI 的 Vidu 平台兼容接口时，统一使用 Bearer Token 鉴权：

路径规则

在 OneLinkAI 中，Vidu 兼容接口统一挂载在 /vidu 前缀下。

示例：

官方路径：/ent/v2/text2video

OneLinkAI 路径：/vidu/ent/v2/text2video

也就是说，如果你已经接入过 Vidu 官方接口，通常只需要：

将请求地址替换为 OneLinkAI 对应兼容地址。

将鉴权方式替换为 OneLinkAI 的 Authorization: Bearer <ApiKey>。

保持原有请求体结构不变后进行联调。

通用调用方式

创建类接口通常返回任务标识 task_id。

创建成功后，建议优先使用查询生成物接口轮询结果。

如果创建接口直接返回错误，请优先检查请求参数、鉴权信息和上游返回报错。

如果任务创建成功但迟迟未完成，建议通过查询接口确认任务状态和结果。

能力清单

以下内容用于快速说明 OneLinkAI 对 Vidu 能力的当前支持范围。实际调用时请以当前目录下的接口文档为准。

创建视频任务

能力名称	是否支持	参考文档
参考生视频	✔️	https://platform.vidu.cn/docs/reference-to-video
文生视频	✔️	https://platform.vidu.cn/docs/text-to-video
图生视频	✔️	https://platform.vidu.cn/docs/image-to-video
首尾帧生视频	✔️	https://platform.vidu.cn/docs/start-end-to-video
智能多帧	✔️	https://platform.vidu.cn/docs/multi-frame
场景特效模板	❌	https://platform.vidu.cn/docs/template
模板成片	❌	https://platform.vidu.cn/docs/template-story

创建图像任务

能力名称	是否支持	参考文档
图片生成	✔️	https://platform.vidu.cn/docs/reference-to-image

创建音频任务

能力名称	是否支持	参考文档
文生音频	❌	https://platform.vidu.cn/docs/text-to-audio
可控文生音效	❌	https://platform.vidu.cn/docs/timing-to-audio
语音合成	❌	https://platform.vidu.cn/docs/text-to-speech
声音复刻	❌	https://platform.vidu.cn/docs/voice-clone

创建其他任务

能力名称	是否支持	参考文档
动作同步	❌	https://platform.vidu.cn/docs/motion-sync
视频延长	❌	https://platform.vidu.cn/docs/video-extension
对口型	❌	https://platform.vidu.cn/docs/lip-sync
数字人	❌	https://platform.vidu.cn/docs/digital-human
推荐提示词接口	❌	https://platform.vidu.cn/docs/prompt-rec
智能超清-尊享	❌	https://platform.vidu.cn/docs/upscale-pro

解决方案类能力

能力名称	是否支持	参考文档
一键生成通用成片	❌	https://platform.vidu.cn/docs/one-click-general-film
一键生成电商成片	❌	https://platform.vidu.cn/docs/one-click-ad-film
一键生成 Ai-Mv	❌	https://platform.vidu.cn/docs/one-click-ai-mv
一键生成视频复刻	❌	https://platform.vidu.cn/docs/one-click-trending-replicate

任务管理

能力名称	是否支持	参考文档
查询生成物接口	✔️	https://platform.vidu.cn/docs/search-task-api
查询列表接口	❌	https://platform.vidu.cn/docs/tasks-list
取消任务接口	❌	https://platform.vidu.cn/docs/cancel-task-api
查询积分接口	❌	https://platform.vidu.cn/docs/search-credits
回调签名算法	❌	https://platform.vidu.cn/docs/callback-signature
错误码清单	❌	https://platform.vidu.cn/docs/error-code

接口详情

以下请求示例统一以 https://api.onelinkai.cloud 作为示例网关地址，实际调用时请替换为你的真实接入地址和有效的 ApiKey。

创建视频任务

参考生视频

官方请求路径：/ent/v2/reference2video

OneLinkAI 路径：/vidu/ent/v2/reference2video

参考文档：https://platform.vidu.cn/docs/reference-to-video

请求参数：整体对标 Vidu 官方文档

响应参数：通常返回 task_id

文生视频

官方请求路径：/ent/v2/text2video

OneLinkAI 路径：/vidu/ent/v2/text2video

参考文档：https://platform.vidu.cn/docs/text-to-video

请求参数：整体对标 Vidu 官方文档

响应参数：通常返回 task_id

图生视频

官方请求路径：/ent/v2/img2video

OneLinkAI 路径：/vidu/ent/v2/img2video

参考文档：https://platform.vidu.cn/docs/image-to-video

请求参数：整体对标 Vidu 官方文档

响应参数：通常返回 task_id

首尾帧生视频

官方请求路径：/ent/v2/start-end2video

OneLinkAI 路径：/vidu/ent/v2/start-end2video

参考文档：https://platform.vidu.cn/docs/start-end-to-video

请求参数：整体对标 Vidu 官方文档

响应参数：通常返回 task_id

智能多帧

官方请求路径：/ent/v2/multiframe

OneLinkAI 路径：/vidu/ent/v2/multiframe

参考文档：https://platform.vidu.cn/docs/multi-frame

请求参数：整体对标 Vidu 官方文档

响应参数：通常返回 task_id

创建图像任务

图片生成

官方请求路径：/ent/v2/reference2image

OneLinkAI 路径：/vidu/ent/v2/reference2image

参考文档：https://platform.vidu.cn/docs/reference-to-image

请求参数：整体对标 Vidu 官方文档

响应参数：通常返回 task_id

任务管理

查询生成物接口

官方请求路径：/ent/v2/tasks/{id}/creations

OneLinkAI 路径：/vidu/ent/v2/tasks/{id}/creations

参考文档：https://platform.vidu.cn/docs/search-task-api

请求参数：整体对标 Vidu 官方文档

响应参数：整体对标 Vidu 官方文档

使用建议

如果你已经接入过 Vidu 官方接口，推荐优先复用原有请求体结构和参数封装。

接入时先联调一个创建类接口，确认能成功返回 task_id。

再联调查询生成物接口，确认任务状态和结果解析正常。

具体字段定义、示例参数、返回结构和边界行为，请以对应接口文档为准。

如后续新增兼容能力或补齐更多接口，本文档会同步更新。

概览#

接入规则#

鉴权方式#

路径规则#

通用调用方式#

能力清单#

创建视频任务#

创建图像任务#

创建音频任务#

创建其他任务#

解决方案类能力#

任务管理#

接口详情#

创建视频任务#

参考生视频#

文生视频#

图生视频#

首尾帧生视频#

智能多帧#

创建图像任务#

图片生成#

任务管理#

查询生成物接口#

使用建议#

概览

接入规则

鉴权方式

路径规则

通用调用方式

能力清单

创建视频任务

创建图像任务

创建音频任务

创建其他任务

解决方案类能力

任务管理

接口详情

创建视频任务

参考生视频

文生视频

图生视频

首尾帧生视频

智能多帧

创建图像任务

图片生成

任务管理

查询生成物接口

使用建议