跳到主要内容

文生视频

更新时间：2025-12-01 13:32:15
根据文本提示生成视频，仅支持异步模式。
POST
https://cloud.baicainfer.com/v1/videos/generations
Authorizations
Authorizations：StringHeaderRequired

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

Body
application/json
selected_model：String

指定生成式任务中要使用的具体模型名称，支持选择“Wan2.1-T2V-1.3B、Wan2.1-T2V-14B、Wan2.2-T2V-5B、Wan2.2-T2V-A14B”。更多模型，可参考支持的模型。

task_type：Enumerate

指定生成式模型需执行的任务类型，用于明确模型的工作目标。

input：object | nullRequired

输入参数集合。

input.prompt：StringRequired

是生成视频时用于描述期望内容（如场景、风格、细节等）的正向提示词。

input.negative_prompt：StringRequired

用于指定生成视频时需避免的元素（如低质量、失真等）的反向提示词，以优化生成结果的质量。

input.resolution：integerRequired

分辨率（480p、720p、1080p）。

input.aspect_ratio：integerRequired

宽高比（4:3、3:4、16:9、9:16、21:9、1:1），若直接提供了 width（宽度）和 height（高度）的具体像素值，系统将直接采用此设定。若未直接指定宽高，但同时提供了 resolution 和 aspect_ratio，系统将根据这两者自动计算出对应的宽高值。例如 16：9 + 720p，计算结果为 1280*720；如9：16 + 720p，计算结果为 720*1280。

input.number_of_videos：integer

指定生成视频的数量，用于控制一次请求返回的视频总数，不传，则默认生成一个视频。

input.true_cfg_scale：numberRequired

指导尺度（通常 1.0 ~ 20.0，常用范围5.0 ~ 15.0）：3.0 - 7.0表示获得更多意外惊喜和创意组合；7.0 - 10.0表示在遵循提示词和图像质量间取得平衡；10.0 - 15.0表示严格遵循文本描述，适合产品设计；1.0 - 5.0表示获得更抽象、interpretive的结果。

input.duration：integerRequired

视频时常。

input.num_inference_steps：integerRequired

推理步数。

input.fps：integerRequired

帧率/帧每秒帧率。

input.image：StringRequired

首帧图。

input.mask_image：String | null

蒙版图，可以为空。

input.last_image：String

尾帧图，任务类型为flf2video（首尾帧生成视频）时需要传递该参数。

lora_settings：array [object]

视频分辨率。

lora_settings.lora_name：StringRequired

是指定要使用的LoRA模型名称。

lora_settings.lora_path：StringRequired

LoRA文件路径。

lora_settings.lora_scale：FloatRequired

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

Response
状态码：
200
application/json
code：String Required

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

0是成功标识，表示接口正常返回预期结果。
message：StringRequired

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

success是成功标识，表示请求完全正常处理，无任何问题。
data：objectRequired

任务的核心结果数据。

data.taskId：StringRequired

任务的唯一标识ID。

ts：StringRequired

响应的时间戳。

curl --location --request POST 'https://cloud.baicainfer.com/v1/videos/generations' \
--header 'Authorization: sk-RVkVZVd57hLruMHEu9t*****' \
--header 'Content-Type: application/json' \
--data-raw '{
    "selected_model": "wanx",
    "task_type": "一只在森林中奔跑的狐狸",
    "input": {
        "prompt": "String",
        "negative_prompt": "String",
        "resolution": 0,
        "aspect_ratio": 0,
        "number_of_videos": 0,
        "true_cfg_scale": 0,
        "duration": 0,
        "num_inference_steps": 0,
        "fps": 0,
        "image": "String",
        "mask_image": "String",
        "last_image": "String"
    },
    "lora_settings": [
        {
            "lora_name": "String",
            "lora_path": "String",
            "lora_scale": "String"
        }
    ]
}'


{
    "code": "String",
    "message": "String",
    "data": {
        "taskId": "String"
    },
    "ts": "String"
}