查询任务
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