生成视频

使用 xianchou generate video 可以提交单次 AI 生视频任务。视频命令支持文生视频、首帧生视频、首尾帧生视频和参考素材生视频。

文生视频

xianchou generate video \
  --prompt "电影感航拍镜头，雨后的未来城市，霓虹反光" \
  --project-id <PROJECT_ID> \
  --poll

不传 --mode 时，如果没有参考素材，CLI 会自动使用 text 模式。文生视频必须提供非空 --prompt。

首帧生视频

xianchou generate video \
  --mode first \
  --first-frame-url "https://xianchou.com/path/to/image.png" \
  --prompt "镜头缓慢推进，角色抬头看向镜头" \
  --project-id <PROJECT_ID> \
  --poll

--first-frame-url 和 --first-image-url 等价，二者任选其一。

首尾帧生视频

xianchou generate video \
  --mode first-last \
  --first-frame-url "https://xianchou.com/start.png" \
  --last-frame-url "https://xianchou.com/end.png" \
  --prompt "从清晨过渡到黄昏" \
  --project-id <PROJECT_ID> \
  --poll

首尾帧模式需要同时提供首帧和尾帧图片 URL。--last-frame-url 和 --last-image-url 等价。

参考素材生视频

xianchou generate video \
  --mode reference \
  --reference-url "https://xianchou.com/reference.png" \
  --prompt "保留主体和风格生成一个动态镜头" \
  --project-id <PROJECT_ID> \
  --poll

参考模式至少需要一类参考素材。可以使用单个 --reference-url，也可以传逗号分隔的 --image-urls 或 --video-urls。

自动推断模式

不传 --mode 时，CLI 会按参考素材自动推断：

条件	推断模式
传入 --last-frame-url 或 --last-image-url	first-last
传入 --first-frame-url 或 --first-image-url	first
传入图片或视频参考素材	reference
没有参考素材	text

--reference-url 会按 URL 后缀判断素材类型，.mp4、.mov、.webm、.m4v 会作为视频参考，其余作为图片参考。

参数

参数	说明
--prompt <prompt>	视频提示词；text 模式必填
--project-id <projectId>	项目 ID；不传时读取配置或 XIANCHOU_PROJECT_ID
--mode <mode>	视频模式：text、first、first-last、reference
--provider-id <providerId>	Provider ID，来自 models video
--model-id <modelId>	Model ID，来自 models video
--channel <channel>	生成通道
--ratio <ratio>	视频比例，例如 16-9
--duration <duration>	视频时长，例如 5s
--resolution <resolution>	分辨率选项
--audio	在模型支持时启用音频
--first-frame-url <url>	首帧图片 URL
--first-image-url <url>	首帧图片 URL，等价于 --first-frame-url
--last-frame-url <url>	尾帧图片 URL
--last-image-url <url>	尾帧图片 URL，等价于 --last-frame-url
--reference-url <url>	单个参考图片或视频 URL
--reference-image-url <url>	单个参考图片 URL
--reference-video-url <url>	单个参考视频 URL
--image-urls <urls>	逗号分隔的参考图片 URL
--video-urls <urls>	逗号分隔的参考视频 URL
--audio-urls <urls>	逗号分隔的参考音频 URL
--audio-url <url>	单个参考音频 URL
--motion <motion>	运动强度或运动选项
--quality <quality>	质量选项
--mj-advanced	启用 Midjourney 高级视频选项
--stylize <value>	Midjourney stylize 数值
--chaos <value>	Midjourney chaos 数值
--weird <value>	Midjourney weird 数值
--poll	轮询任务直到成功或失败

默认模型与参数

如果没有传 --provider-id、--model-id、--channel、--ratio、--duration 或 --resolution，CLI 会读取 models video。它会优先选择匹配当前 --mode 的模型，再使用模型或目录中的默认比例、时长和分辨率。