跳到主要内容

文生视频

更新时间:2026-04-13
根据文本提示生成视频,仅支持异步模式。调用该接口后,您可通过调用「查询任务生成结果」接口获取视频的生成结果。
POST
https://cloud.baicainfer.com/v1/videos/generations
Authorizations
AuthorizationsStringHeaderRequired

用户需使用已获取的API Key进行身份验证,以访问服务。

Body
application/json
selected_modelStringRequired

模型名称。更多模型,可参考支持的模型和应用

取值范围:Wan2.1-T2V-14B-Fast
默认值:-
约束限制:-
task_typeStringRequired

指定生成式模型需执行的任务类型。更多任务类型,可参考支持的模型和应用

取值范围:txt2video
默认值:-
约束限制:-
inputObjectRequired

输入参数集合。

input.promptStringRequired

用于生成视频的正向提示词。

取值范围:1~800
默认值:-
约束限制:支持中英文,超出字符限制部分会自动截断。
input.negative_promptString

用于指定生成视频时需避免的元素(如低质量、失真等)的反向提示词。

取值范围:1~500
默认值:-
约束限制:支持中英文,出字符限制部分会自动截断。
input.resolutionStringRequired

分辨率。

取值范围:480p、720p
默认值:-
约束限制:-
input.aspect_ratioString

宽高比。

取值范围:1:1、2:3、3:4、4:3、9:16、16:9
默认值:16:9
约束限制:-
input.durationIntRequired

视频时长,单位s。

取值范围:5
默认值:-
约束限制:-
input.number_of_videosInt

指定生成视频的数量。

取值范围:1~4
默认值:1
约束限制:-
input.num_inference_stepsInt

指定生成模型迭代优化的次数,次数越多生成视频细节越精细、质量越高,但同时会增加生成耗时。

取值范围:1~50
默认值:28
约束限制:-
input.true_cfg_scaleFloat

调节模型在生成时遵循文本提示词的程度,数值越大生成内容与提示词越一致,但可能降低多样性或导致过饱和。

取值范围:0~20
默认值:9.0
约束限制:-
input.seedInt

生成式模型中控制结果随机性的种子,固定它可复现相同结果,改变则生成不同内容。

取值范围:-1~4294967295
默认值:-1
约束限制:-
need_expand_promptBoolean

是否打开提示词优化。

取值范围:true、false
默认值:false
约束限制:-
asyncBoolean

是否采用异步方式处理请求。

取值范围:true、false
默认值:true
约束限制:-
lora_settingsarray [object]

是用于配置LoRA(低秩适应)模型的参数集合,包括LoRA名称和缩放因子,用于微调生成结果的风格或特征。

lora_settings.lora_nameString

是指定要使用的LoRA模型名称。更多详情,可参考预置的LoRA微调模型

取值范围:Wan2.1-I2V-14B-480P_oP5vD9(国风变身)、Wan2.1-I2V-14B-480P_uN0aT5(骑行镜头)、Wan2.1-I2V-14B-480P_vR2fD4(万物花开)
默认值:-
约束限制:-
lora_settings.lora_scaleFloat

是控制LoRA模型对生成结果影响程度的缩放因子,值越大,LoRA微调效果越显著。

取值范围:(0,1]
默认值:1
约束限制:-
Response
状态码:application/json
codeIntRequired

表示请求处理状态的状态码。

0是成功标识,表示接口正常返回预期结果。
messageStringRequired

返回请求的处理结果,通常配合状态码使用,直观告知用户当前请求的具体情况。

dataobjectRequired

任务的核心结果数据。

data.taskIdStringRequired

任务的唯一标识ID。

tsStringRequired

响应的时间戳。

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.1-T2V-14B-Fast",
    "task_type": "txt2video",
    "input": {
        "prompt": "小羊在草原吃草",
        "resolution": "480p",
        "duration": 5
     }
}'
{
    "code": 0,
    "message": "任务提交成功",
    "data": {
        "taskId": "3524e0b3ba014b12ab1faf29f9f*****"
    },
    "ts": "2026-02-02T10:44:54.716004004+08:00[Asia/Shanghai]"
}