Skip to main content

查询任务

GET /ent/v2/tasks/{id}/creations 根据任务 ID 查询生成结果。

请求参数 (Query / Path)

string
required
路径中的资源 / 任务 ID

请求示例 (cURL)

响应示例 (200 OK)


查询任务

GET /vidu-native/video/generations/{task_id} 给定一个提示,该模型将返回一个或多个预测的完成,并且还可以返回每个位置的替代标记的概率。 为提供的提示和参数创建完成

请求参数 (Query / Path)

string
required
异步任务 ID
string
required
请求体 Content-Type,一般为 application/json
string
required
期望的响应 Content-Type
string
Bearer API Key
string
转发原始 Host(代理场景)

请求示例 (cURL)

响应示例 (200 OK)


语音合成 TTS

POST /ent/v2/audio-tts 文本转语音。

请求体参数 (Body)

string
required
待合成文本
integer
音高
number
语速
string
required
音色 ID
integer
音量

请求示例 (cURL)

响应示例 (200 OK)


图生视频

POST /ent/v2/img2video 以首帧图片生成视频。

请求体参数 (Body)

string
宽高比,如 16:9、9:16、1:1
boolean
音频相关参数或 URL
string
任务完成回调 URL
integer
视频时长(秒)
array
required
首帧图片 URL,仅 1 张
string
required
模型名称
string
文本提示词
string
分辨率,如 720p/1080p
integer
随机种子,0 为随机
boolean
是否添加水印

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)


参考生图

POST /ent/v2/reference2image 参考图片生成图像。

请求体参数 (Body)

string
宽高比,如 16:9、9:16、1:1
array
图片 URL 或 Base64 列表
string
required
模型名称
string
required
文本提示词
string
分辨率,如 720p/1080p

请求示例 (cURL)

响应示例 (200 OK)


参考生视频

POST /ent/v2/reference2video 多图/视频参考生成视频。

请求体参数 (Body)

string
宽高比,如 16:9、9:16、1:1
string
任务完成回调 URL
integer
视频时长(秒)
array
图片 URL 或 Base64 列表
string
required
模型名称
string
required
文本提示词
string
分辨率,如 720p/1080p
integer
随机种子,0 为随机
array
主体 / 角色参考列表
boolean
是否添加水印

请求示例 (cURL)

响应示例 (200 OK)


首尾帧生视频

POST /ent/v2/start-end2video 首帧 + 尾帧生成过渡视频。

请求体参数 (Body)

string
宽高比,如 16:9、9:16、1:1
string
任务完成回调 URL
integer
视频时长(秒)
array
required
图片 URL 或 Base64 列表
string
required
模型名称
string
文本提示词
string
分辨率,如 720p/1080p
integer
随机种子,0 为随机
boolean
是否添加水印

请求示例 (cURL)

响应示例 (200 OK)


文生音频

POST /ent/v2/text2audio 根据文本描述生成音频。

请求体参数 (Body)

number
2–10 秒
string
required
模型名称 / 型号 ID
string
required
文本提示词

请求示例 (cURL)

响应示例 (200 OK)


文生视频

POST /ent/v2/text2video 根据文本提示词生成视频。

请求体参数 (Body)

string
宽高比,如 16:9、9:16、1:1
boolean
是否添加背景音乐
string
任务完成回调 URL
integer
视频时长(秒)
string
required
模型名称
string
required
文本提示词
string
分辨率,如 720p/1080p
integer
随机种子,0 为随机
string
风格参数
boolean
是否添加水印

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)


创建视频

POST /vidu-native/video/generations

请求参数 (Query / Path)

string
required
请求体 Content-Type,一般为 application/json
string
required
期望的响应 Content-Type
string
Bearer API Key

请求体参数 (Body)

string
required
可选为 2:3, 3:2, 1:1
array
required
图片链接
string
required
模型名称。常用枚举: viduq2 viduq2-pro viduq2-turbo viduq3-pro viduq3-turbo
string
required
提示词
string
required
720P或者1080P

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)