文生视频
根据文本提示生成视频,支持生成音频,同时仅支持异步模式。调用该接口前,您需要先通过调用「上传文件」接口获取输入的音频路径;调用该接口后,您可通过调用「查询任务生成结果」接口获取视频的生成结果。
POST
https://cloud.baicainfer.com/v1/videos/generations
Authorizations
Body
application/json
input:ObjectRequired
输入参数集合。
input.prompt:StringRequired
用于生成视频的正向提示词。
取值范围:
1~800默认值:-
约束限制:支持中英文,超出字符限制部分会自动截断。
input.negative_prompt:String
用于指定生成视频时需避免的元素(如低质量、失真等)的反向提示词。
取值范围:
1~500默认值:-
约束限制:支持中英文,超出字符限制部分会自动截断。
input.generate_audio:Boolean
是否自动生成音频。
取值范围:
true、false默认值:false
约束限制:-
input.audio_url:String
用户自行上传的音频。若同时传入generate_audio参数,系统将优先使用用户上传的音频。
取值范围:
-默认值:-
约束限制:音频格式:wav、mp3;音频大小:≤15MB;音频时长:5s、10s,若音频长度超过duration值(如5s),自动截取前5s,其余部分丢弃。若音频长度不足视频时长,超出音频长度部分为无声视频。
input.resolution:StringRequired
分辨率。
取值范围:
480p、720p、1080p默认值:-
约束限制:-
input.aspect_ratio:String
宽高比。
取值范围:
1:1、3:4、4:3、9:16、16:9默认值:16:9
约束限制:-
input.duration:IntRequired
视频时长,单位s。
取值范围:
5、10默认值:-
约束限制:-
input.number_of_videos:Int
指定生成视频的数量。
取值范围:
1~4默认值:1
约束限制:-
need_expand_prompt:Boolean
是否打开提示词优化。
取值范围:
true、false默认值:false
约束限制:-
async:Boolean
是否采用异步方式处理请求。
取值范围:
true、false默认值:true
约束限制:-
Response
状态码:application/json
200
code:IntRequired
表示请求处理状态的状态码。
0
400
500
0是成功标识,表示接口正常返回预期结果。
message:StringRequired
返回请求的处理结果,通常配合状态码使用,直观告知用户当前请求的具体情况。
data:objectRequired
任务的核心结果数据。
data.taskId:StringRequired
任务的唯一标识ID。
ts:StringRequired
响应的时间戳。
cURL
Python
JavaScript
curl --location --request POST 'https://cloud.baicainfer.com/v1/videos/generations' \
--header 'Authorization: Bearer sk-RVkVZVd57hLruMHEu9t*****' \
--header 'Content-Type: application/json' \
--data-raw '{
"selected_model": "Wan2.5-T2V-Preview",
"task_type": "txt2video",
"input": {
"prompt": "小羊在草原吃草",
"resolution": "480p",
"duration": 5
}
}'
200
400
401
404
500
{
"code": 0,
"message": "任务提交成功",
"data": {
"taskId": "3524e0b3ba014b12ab1faf29f9f*****"
},
"ts": "2026-02-02T10:44:54.716004004+08:00[Asia/Shanghai]"
}