07-视频模型指南

指定首帧图片

视频生成需要指定首帧图片，有以下两种方式：

方式一：使用悠船生成的图像

通过传入 jobId 和 imageNo 指定视频的首帧。适用于先用图像生成接口创建图片，再将其转化为视频的工作流。

方式二：使用自定义图像

在 prompt 字段中通过图片 URL 指定视频首帧：

import requests

url = "https://ali.youchuan.cn/v1/tob/video-diffusion"
headers = {
    "x-youchuan-app": "YOUR_APP_ID",
    "x-youchuan-secret": "YOUR_SECRET_KEY"
}

# 方式一：基于已有图像生成视频
data_with_image = {
    "jobId": "existing_job_id",
    "imageNo": 0,
    "prompt": "Make this image move with gentle animation",
    "callback": "https://your-callback-url.com"
}

response = requests.post(url, headers=headers, json=data_with_image)
print(response.json())

# 方式二：文本生成视频
data = {
    "prompt": "A beautiful sunset over the ocean with gentle waves",
    "callback": "https://your-callback-url.com"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

文本提示词

文本提示词为可选项，但以下情况必须提供文本提示词：

• 使用 --raw 参数时，文本提示词不能为空

分辨率与画质

悠船支持 480p 和 720p 两种视频规格：

• 480p（默认）：标准画质，费用系数 4.0

• 720p：高清画质，费用系数 12.0（为 480p 的 3 倍）

视频尺寸

480p 视频尺寸基于原始图像比例自动适配：

批次数量费用系数

运动强度（--motion）

控制视频中画面元素的动作幅度：

• --motion low（默认）：适合静态场景和细微动作，如人物微表情、树叶轻摇

• --motion high：大幅镜头运动和画面变化，可能产生更具艺术感的效果

Raw 模式（--raw）

使用 --raw 参数可减少系统自动修饰，获得更精准的效果控制。

注意：使用 --raw 时，文本提示词不能为空。

尾帧指定（--end）

通过 --end [图片URL] 指定视频的尾帧画面，用于控制视频的结束状态。

视频循环（--loop）

使用 --loop 参数生成首尾帧一致的无缝可循环视频。

注意：--loop 不支持与 --end 同时使用。

视频延长

使用视频延长接口对生成的视频进行延长：

• 每次延长增加 4 秒 时长

• 最多可延长 4 次（即最终 21 秒视频）

视频高清

使用视频高清接口生成 1080P 分辨率的高清视频。

任务系数

批次数量系数

示例：生成一个 480p 视频（--bs 4）的费用为：0.6 × 4.0 × 1.0 = 2.4 元。