vidu 接口文档(vidu官方数据格式) 完整版

基础信息

Base URL: https://aifast.site

认证方式: Authorization: Bearer {your_api_key}

Content-Type: application/json

模型版本说明

文生视频，参考生视频：TC-vidu-q2

图生视频，首尾帧视频：TC-vidu-q2-pro, TC-vidu-q2-turbo, TC-vidu-q3-turbo

文生视频，图生视频：TC-vidu-q3-pro, TC-vidu-q3-turbo

任务类型	支持模型 (model)
文生视频	`TC-vidu-q2`、`TC-vidu-q3-pro`、`TC-vidu-q3-turbo`
图生视频	`TC-vidu-q2-pro`、`TC-vidu-q3-pro`、`TC-vidu-q3-turbo`
首尾帧	`TC-vidu-q2-pro`、`TC-vidu-q2-turbo`、`TC-vidu-q3-turbo`
参考生视频	`TC-vidu-q2`
未指定

1. 创建视频生成任务

Endpoint:

文生视频：POST /api/v1/video/vidu/text2video

图生视频：POST /api/v1/video/vidu/img2video

参考生视频：POST /api/v1/video/vidu/reference2video

首尾帧生视频：POST /api/v1/video/vidu/start-end2video

请求参数

参数	子参数	类型	必填	说明
model		string	是	模型枚举值选项见【模型版本说明】
prompt		string	是	视频生成提示词
duration		int	否	视频时长默认5s
aspect_ratio		string	否	尺寸默认 16:9 可选值: 16:9、9:16、3:4、4:3、1:1 注: 3:4、4:3仅支持q2模型
resolution		string	否	分辨率默认720p
subjects		List[Array]	否	参考生视频依赖的图片信息
	images	Array[String]	是	图片的url
	id	string	否	主体id，后续生成时可以通过@主体id的方式使用
	voice_id	string	否	音色ID用来决定视频中的声音音色，为空时系统会自动推荐，可选枚举值参考列表 https://shengshu.feishu.cn/sheets/EgFvs6DShhiEBStmjzccr5gonOg
images		[]string	否	- 图生视频仅支持上传一张图片 - 首尾帧生视频时支持输入两张图，上传的第一张图片视作首帧图，第二张图片视作尾帧图，模型将以此参数中传入的图片来生成视频
off_peak		bool	否	是否错峰模式
callback_url	回调地址	string	否	需要您在创建任务时主动设置callback_url，请求方法为POST，当视频生成任务有状态变化时，将向此地址发送包含任务最新状态的回调请求。

callback参数内容

{
  "state": "success", // 成功-success 失败-fail
  "err_code": "生成失败的错误信息",
  "creations": {
    "id": "xxx", // 任务id
    "url": "xxxx", // 生成的视频url
    "cover_url": "xxxx" // 生成的视频封面url
  }
}

请求示例

文生视频 /api/v1/video/vidu/text2video

图生视频(支持多张图) /api/v1/video/vidu/img2video

参考生视频 /api/v1/video/vidu/reference2video

首尾帧 /api/v1/video/vidu/start-end2video

响应参数

参数	类型	说明
task_id	string	任务ID
state	string	处理状态：created（创建成功）、queueing（任务排队中）、processing（任务处理中）、success（任务成功）、failed（任务失败）
model	string	使用的模型
credits	int	本次任务消耗的积分数
prompt	string	提示词
duration	int	视频时长，单位秒
error_msg	string	错误信息（失败时返回）
created_at	string	创建时间（ISO 8601格式）

响应示例

2. 查询视频生成任务

Endpoint:
GET /api/v1/video/generations/{id}
GET /api/v1/video/vidu/tasks/:id/creations

路径参数

参数	类型	必填	说明
id	int64	是	任务ID

响应参数

参数	类型	说明
id	int	任务ID
state	string	处理状态：created（创建成功）、queueing（任务排队中）、processing（任务处理中）、success（任务成功）、failed（任务失败）
model	string	使用的模型
prompt	string	提示词
error_msg	string	错误信息（失败时返回）
credits	int	本次任务消耗的积分数
created_at	string	创建时间（ISO 8601格式）
result_url	string	生成的视频url
off_peak	bool	错峰模式

响应示例

错误码

状态码	错误码	说明
400	INVALID_REQUEST	请求参数无效
401	UNAUTHORIZED	未授权，API密钥无效
403	FORBIDDEN	禁止访问，余额不足或权限不够
404	NOT_FOUND	任务不存在
429	RATE_LIMIT_EXCEEDED	请求频率超限
500	INTERNAL_ERROR	服务器内部错误

注意事项

图片格式支持: JPG、PNG、JPEG、WEBP

图片大小限制: 单张图片不超过10MB

参考图片数量: 最多支持7张参考图片

视频时长: 支持1-10秒

并发限制: 每个用户最多同时处理5个任务

vidu 接口文档(vidu官方数据格式) 完整版

vidu 接口文档(vidu官方数据格式) 完整版#

基础信息#

模型版本说明#

1. 创建视频生成任务#

Endpoint:#

请求参数#

callback参数内容#

请求示例#

文生视频 /api/v1/video/vidu/text2video#

图生视频(支持多张图) /api/v1/video/vidu/img2video#

参考生视频 /api/v1/video/vidu/reference2video#

首尾帧 /api/v1/video/vidu/start-end2video#

响应参数#

响应示例#

2. 查询视频生成任务#

路径参数#

响应参数#

响应示例#

错误码#

注意事项#

vidu 接口文档(vidu官方数据格式) 完整版

基础信息

模型版本说明

1. 创建视频生成任务

Endpoint:

请求参数

callback参数内容

请求示例

文生视频 /api/v1/video/vidu/text2video

图生视频(支持多张图) /api/v1/video/vidu/img2video

参考生视频 /api/v1/video/vidu/reference2video

首尾帧 /api/v1/video/vidu/start-end2video

响应参数

响应示例

2. 查询视频生成任务

路径参数

响应参数

响应示例

错误码

注意事项