scenario-luma-video

Scenario Luma Video

概览

Scenario 上的 Luma 视频系列包含四个同系列模型，每种模式各一个：Ray 3.2 根据文本或帧锚点生成视频，Ray 3.2 Edit 在结构控制下为素材重新设计风格，Ray 3.2 Reframe 通过扩展画面适配新的宽高比，而 Modify Video 则用于经济实惠的提示词编辑。调整任何参数前，先按成员选择模型；Luma 的图像模型属于 scenario-luma-image 技能。使用 search 查找当前可用模型，并将 model_schema_get 视为规范。

连接方式和核心流程：请参阅此仓库中的 scenario 技能；与模型无关的视频工作：请参阅 scenario-video 技能。如果你可用的技能中缺少此处提到的同系列技能，请让用户安装（npx skills add scenario-labs/skills --skill <name>）；若无人值守，则根据工具架构继续操作，并指出这一缺口。

快速参考

每种模式都是独立模型（名称来自实时架构，能力上限为本文撰写时的数据）：

成员	输入	行为
Ray 3.2	prompt（可选 startFrame、endFrame）	文本或图像生成视频；endFrame 仅在同时提供 startFrame 时有效
Ray 3.2 Edit	video + prompt	保留动作和时序的同时重新设计风格；使用 editStrength 和其他控制项
Ray 3.2 Reframe	video + prompt + aspectRatio	通过扩展画面适配新的宽高比，绝不裁剪；提示词用于填充画布
Modify Video	video（可选 prompt、firstFrame）	通过 mode 梯度进行经济实惠的提示词编辑；源视频最长 30 秒、最大 100 MB

Ray 3.2 的选项彼此排斥。本文撰写时，duration 是单位字符串，例如 "5s" 或 "10s"，而不是数字；"10s" 不接受 loop、hdr、startFrame 和 endFrame。hdr 要求从 540p、720p、1080p 的 resolution 列表中选择 720p 或 1080p；六种 aspectRatio 值涵盖 9:16 到 21:9。Edit 和 Reframe 共用该分辨率列表；Modify Video 没有分辨率参数。duration、resolution 和 hdr 都会影响价格（本文撰写时，1080p 的价格和等待时间是 720p 的数倍），因此批量处理前先对选项集运行 dry_run。

两种编辑器，同一强度梯度

Ray 3.2 Edit 和 Modify Video 使用相同的九档梯度重新设计风格，即 adhere_1 到 reimagine_3（adhere 尽量保持原样，flex 重新设计风格但保留可识别元素，reimagine 则进行变换），除此之外，两者几乎没有共同点。Edit 将此梯度命名为 editStrength；Modify 将其命名为 mode。Edit 可将引导图像作为 startFrame；Modify 的 firstFrame 是对源视频首帧的编辑副本，而非任意风格图像。只有 Edit 提供 keyframes（最多 64 个图像和索引锚点，不能与单个 startFrame 引导帧同时使用）、面部、姿势、深度、法线和轨迹控制选项、分辨率选择以及 hdr；或者传入 autoControls: true，以取代手动设置 editStrength。本文撰写时，两者的价格相差近两个数量级，因此可对同一片段分别运行 dry_run，仅在确实需要 Edit 的控制项时才为其付费。

描述动作，而非堆砌形容词

Ray 更适合大约 50 到 300 个词的自然语言提示词，并围绕动作来构建：主体正在进行某个动作，点明一种镜头运动（缓慢推进、手持跟拍），再描述动作带来的一个物理结果（水滴四散、尘土飞扬）。具体的光线描述能直接发挥作用。使用 loop 时，应保持动作强度稳定（持续的降雨、飘散的蒸汽），让循环自然衔接。使用 Reframe 时，只描述画面边缘：说明新画布应包含什么，并让原主体保持不变。

示例：将 16:9 主视觉片段重新裁切为 9:16

1. 使用 search，设置 target="models"、query="luma"、public=true。优先选择最新的非弃用版本， 例如 model_luma-ray-3-2 及其 Edit 和 Reframe 同系列模型（撰写时的实时搜索结果：每次会话都要重新搜索）。
2. 使用生成器 ID 调用 model_schema_get：首先了解选项及其限制。
3. 使用 upload_asset 上传产品静帧（参见 scenario 技能），获取资源 ID。
4. 使用相应的 model_id 调用 model_run，设置 dry_run=true，并使用准确的 parameters={"prompt": "A crystal perfume bottle catches soft window light as a single drop arcs off the stopper, slow push-in, product commercial style.", "startFrame": "asset_a", "duration": "5s", "resolution": "1080p", "aspectRatio": "16:9"}； 每次更改选项后都要重新估算。
5. 再次调用 model_run，设置 wait=false，然后使用返回的任务 ID 调用 jobs_wait；超时时，使用 pending_job_ids 再次调用，绝不要再次调用 model_run。
6. 对 Reframe 同系列模型调用 model_schema_get，然后使用 parameters={"video": "<generated asset id>", "aspectRatio": "9:16", "prompt": "continue the marble counter downward and the softly lit wall upward", "resolution": "1080p"} 调用 model_run， 并遵循相同的等待规则。
7. 使用 asset_display 查看两者，并在交付前检查扩展生成的边缘。

常见错误

• duration: 5 或 "5"：Ray 3.2 需要带单位的字符串 "5s" 或 "10s"。
• 10 秒循环、HDR 调色或帧锚点："10s" 不支持这三项；改用 "5s"。
• 在 Modify Video 上使用 Ray 参数名：它使用 firstFrame 和 mode，而不是 startFrame 和 editStrength。
• 在 Edit 上同时使用 editStrength 和 autoControls，或同时使用 startFrame 和 keyframes：这两组参数互斥。
• 在 Reframe 提示词中描述整个场景：提示词只描述新增画布的内容；源主体会保留。
• 在 Ray 提示词中使用 Vibrant、whimsical 或 hyper-realistic：这些词会降低此系列模型的输出质量。