自动化
通过 Reela CLI 完成订阅创建视频，并将已完成的结果接入你的工作流。
通过 Reela CLI 完成订阅创建视频，并将已完成的结果接入你的工作流。
Reela 提供视频制作命令和已完成视频的完成订阅。智能体或其他工具可以提交简报，并通过 CLI 守护进程接收输出，无需一直打开 Reela 网站。
从简报到视频
create 可将文本简报和可选媒体转换为视频任务。你可以直接提供提示词或从文件读取，选择时长和布局，添加数字人，并附上参考图片、视频素材或背景音乐。
reela create --prompt-file brief.txt \
--visual ai-video --layout portrait --duration 30 \
--session "Product campaign" --output json视频生成是一项长时间运行的任务。请先启动守护进程并配置完成订阅，再提交任务；Reela 会在后台运行生成，并将完成的结果发送给你的脚本。重复使用会话标题可将相关视频归入同一项目。有关设置，请参阅下文的自动交付。
提交前，添加 --dry-run，以验证请求并预览预估积分；此操作不会上传文件或创建任务。提交任务可能会消耗积分。
支持的视觉内容和媒体输入，请参阅视频创建选项。
通过档位选择质量和成本
档位可让你为每个请求选择生成选项。Reela 会提供说明，帮助你或智能体为预期结果选择合适的选项，并在提交前估算该请求所需的积分。
reela tiers list
reela tiers list --output json列表会显示每个档位的标签和说明，并标明默认选项。在 JSON 输出中，tiers 包含带有 label、content 和 is_default 的条目；default_tier 指定默认选项。请阅读 content，了解每个选项，而不要按其在列表中的位置进行选择。列出档位并不代表你的账户可以使用所有选项；Reela 会在验证或提交请求时检查访问权限。
将准确的标签传给 --tier。将下方的 <tier-label> 替换为列表中的标签；如果标签包含空格，请保留引号：
reela create --prompt-file brief.txt --visual ai-video \
--tier "<tier-label>" --duration 30 --layout portrait \
--dry-run --output json预览会返回 credits_cost 和 quota_after。要提交任务，请移除 --dry-run，并保留所选档位和其他选项。档位描述的是生成选项；请使用预览估算实际请求的成本。
如果省略 --tier，Reela 将使用 CLI 当前可用的默认选项。如果没有可用的默认选项，请运行 reela tiers list 刷新选项，或明确指定档位。明确选择档位可使工作流的选择不受默认选项变动影响；但可用性和定价仍可能变化。列出、预览和提交时，请使用同一配置文件。
有关输出详情和选择行为，请参阅档位命令参考。
面向智能体和工具的结构化结果
--output json 会将命令结果（包括档位选项、积分估算和提交确认）以结构化数据的形式提供。退出代码 0 表示命令成功；错误使用非零退出代码，并将纯文本写入 stderr，包括 JSON 模式下也是如此。
成功提交后，守护进程会等待任务完成，并调用你订阅的脚本，传入结果。提交响应和完成事件都包含 task_id，以便你的工作流将已完成的视频与其原始简报关联起来。
自动交付
视频任务完成时，Reela CLI 可以运行你自己的可执行文件。此完成订阅可将 Reela 的输出接入后续操作：将视频交给发布工具、更新记录，或通知其他系统。Reela 会监控任务是否完成，并向脚本提供任务详情。
注册脚本
请提供一台运行 Reela CLI 的计算机上可执行文件的绝对路径。脚本可以使用任何语言，只要能从 stdin 读取事件，并通过退出代码报告成功即可。
reela subscribe add script --path /absolute/path/on-video \
--timeout-seconds 300 --max-retries 3每个配置文件只能订阅一个脚本。要更改现有订阅的可执行文件，请使用 reela config set delivery.script.path /absolute/path/on-video。更改订阅或其设置后，请按下文所述重启正在运行的守护进程。
接收完成事件
Reela 会启动可执行文件，并向 stdin 写入一个 JSON 对象：
{
"event": "task.completed",
"task_id": "12345",
"status": "completed",
"status_label": "completed",
"title": "Product demo",
"description": "A short product introduction",
"download": {
"filename": "product-demo.mp4",
"download_url": "https://example.com/video.mp4"
}
}使用 task_id 将事件与原始提交关联起来。title、description 和 download 可能为 null。存在时，download 会提供已完成视频的建议文件名和下载 URL，供脚本直接使用。在运行需要视频的操作之前，请先处理 download 值缺失的情况。
签名 download_url 链接会在生成 6 小时后过期。收到完成事件后，请尽快下载视频或将其复制到自己的存储空间。请对下载 URL 保密，并将其视为临时访问链接，而非永久视频地址。
订阅会接收所选账户下已完成的任务，包括在 CLI 之外创建的视频。如果操作属于特定工作流，请将事件中的任务 ID 与你提交的任务进行匹配。目前，完成订阅仅处理成功完成的任务；失败、已取消或部分完成的任务不会触发此事件。
执行和重试
- **成功：**操作成功后以
0退出。Reela 会丢弃脚本的 stdout；不会将打印输出用作结果。 - 超时：
--timeout-seconds 300允许每次调用最多运行 300 秒。超时或非零退出都会导致交付失败。 - **重试：**Reela 会重试失败的交付。如果仅脚本方法失败，
--max-retries 3允许总共尝试三次，包括首次尝试。如果失败涉及其他已启用的方法，则使用delivery.max_retries。 - **重复交付：**请确保针对同一个
task_id重复执行时操作安全，以免再次调用导致同一视频被重复发布或同一记录被重复追加。
保持订阅运行
CLI 守护进程负责处理完成事件并运行已启用的交付方式。选择交付方式后，请启动守护进程并检查交付状态：
reela daemon start
reela subscribe status添加一种交付方式时，也会尝试启动已停止的守护进程。如果守护进程已在运行，请在更改交付设置后重启，使设置生效。对于手动启动的守护进程，请依次使用 reela daemon stop 和 reela daemon start。
Reela 会保存交付进度，并在守护进程重启时从保存的进度继续。没有已保存的进度时，默认从新事件开始处理。没有已保存的进度时，reela daemon start --keep-backlog 也会处理仍可用的较早已完成任务事件。
使用 reela daemon install 可启用登录时启动。如果已将其安装为服务，请在配置更改后通过操作系统的服务管理器重启。检查 reela daemon status 或 reela daemon logs --tail 50 可查看交付情况。
自动交付要求运行守护进程的计算机保持开机且联网。对于希望由脚本在完成时触发操作的视频，请先启动守护进程，再提交任务。
Linux 和 macOS 上可使用 daemon 和 subscribe。Windows x64 支持视频命令、状态查询和手动下载。
可选的下载和邮件交付
你可以在脚本之外启用自动下载或已完成视频邮件。默认交付设置中已启用下载；使用 reela config set delivery.download ~/Videos/reela 设置保存位置。如果已禁用，请使用 reela subscribe add download --dir ~/Videos/reela 启用。使用 reela subscribe add email 启用邮件；还可选择添加 --address me@example.com，以使用不同于账户邮箱的地址。
多种交付方式可以同时启用，某种方式失败不会阻止其他方式运行。每次脚本调用都会收到各自的完成内容，其中包含可用的下载信息。所有交付方式请参阅交付命令参考。
复用制作设置
Reela 还提供其他可用于构建工作流步骤的功能：
- **保持品牌一致：**使用
brand list列出现有品牌套件，并使用brand apply将其中一个应用到任务。命令会等待带品牌元素的输出。请参阅品牌命令。 - **以编程方式编辑：**使用
edit下载编辑 JSON、验证更改、保存草稿以供预览，并提交渲染。请参阅编辑命令。 - **独立的账户和偏好设置：**使用
--profile或REELA_PROFILE选择配置文件。交付方式和设置适用于所选配置文件。请参阅配置文件和配置。
例如，产品视频工作流可以提交带有参考图片的简报，并通过守护进程完成订阅将成片交给发布工具。Reela 提供后台生成和完成交付；你的工具决定何时提交，以及结果到达后采取什么操作。