WorkRally AI 生成指南
详细说明 WorkRally 的图片生成、视频生成、三种视频驱动模式、画布自动占位、任务轮询和模型动态获取规则。
This page is accessible in English navigation, but the full body has not been translated yet. The original Chinese content is kept below for accuracy.
核心规则
- 生图前先跑 `workrally generate image-models -o json`。
- 生视频前先跑 `workrally generate video-models -o json`。
- 不同环境可用模型不一样，严禁硬编码 `model_id` 或 `provider_id`。
- 传入 `--project-id` 时，这里指的是画布 ID，不是项目 ID。
图片生成
WorkRally 的图片生成围绕 Kontext 模型展开。除了纯文生图，还支持多参考图输入， 但参考图数量上限由模型动态下发的 `kontext_config.max_input_images` 决定。
image-flow.shbash
# 1. 先拿模型
workrally generate image-models -o json
# 2. 纯文生图
workrally generate image \
--prompt "一只橘猫坐在樱花树下" \
--model <model_id> \
--aspect-ratio 16:9 \
--poll
# 3. 参考图生图
workrally generate image \
--prompt "第一张图片趴在第二张图片路中间" \
--model <model_id> \
--input-images "https://image1,https://image2" \
--poll图片生成关键参数
| 参数 | 说明 | 重点 |
|---|---|---|
| --model | 从 image-models 返回的 model_id 中选取 | 不能手写猜测值 |
| --input-images | 逗号分隔的参考图 URL | 必须是官方媒资 URL |
| --aspect-ratio | 宽高比，如 1:1 / 16:9 / 9:16 | 默认 16:9 |
| --resolution | 分辨率等级，具体看模型支持 | 不同模型支持不同 |
| --count | 生成数量 1-4 | count>1 会并发发起多个独立任务 |
视频生成
视频生成按驱动模式区分，不是所有模型都支持所有输入类型。你需要先看 `video-models` 返回的 `duration_options`、`resolution_options` 和各种 `max_*_count`。
video-flow.shbash
# 先拿视频模型
workrally generate video-models -o json
# Text 模式
workrally generate video \
--prompt "夕阳下海浪拍打沙滩" \
--model <provider_id> \
--poll
# FirstLastFrame 模式
workrally generate video \
--mode FirstLastFrame \
--prompt "角色从左走到右" \
--model <provider_id> \
--first-frame-url "https://start.png" \
--last-frame-url "https://end.png" \
--poll
# SubjectToVideo 模式
workrally generate video \
--mode SubjectToVideo \
--prompt "角色在场景中行走" \
--model <provider_id> \
--reference-assets '[{"type":"image","url":"https://character.png"}]' \
--poll视频生成三种模式
| 参数 | 说明 | 重点 |
|---|---|---|
| Text | 纯文生视频，或单图驱动视频 | 默认模式，最通用 |
| FirstLastFrame | 首尾帧驱动 | 至少传首帧或尾帧之一 |
| SubjectToVideo | 参考主体驱动 | 通过 reference-assets 传素材数组 |
画布内自动占位
当你在 generate image 或 generate video 里传入 --project-id <画布ID> 时， 系统会自动在画布创建 running 状态的占位节点。这个行为是内建的。
- 不需要再手动 `canvas build-draft` 创建生成器节点。
- 生成完成后，前端会自动刷新节点状态。
- 如果你只是要把“已有素材”摆进画布，才用 `canvas build-draft`。
任务轮询
task-flow.shbash
# 自动轮询
workrally generate image --prompt "..." --model <id> --poll
# 手动查询
workrally generate task <task_id> -o json
workrally generate task <task_id> --poll`--poll` 是最省事的方式。它会自动提交任务、按固定间隔轮询并在完成后输出结果。 如果你要手动追踪任务，则使用 `generate task` 查询状态。