scenario-luma-image

Scenario Luma 图像

概览

Uni-1 是 Luma Labs 在 Scenario 上的图像系列，它将生成和编辑整合到同一套契约中：每个成员都同时支持 txt2img 和 img2img，传入 source 图像就会将运行切换为编辑模式，因此图像放在何处（source 还是参考图）比提示词措辞影响更大。这些推理模型会在渲染前规划光线和构图，所以一次运行需要一两分钟，而不是几秒。使用 search 查找成员，并将 model_schema_get 视为契约：各档位共享所有字段名称，但上限和价格不同。Luma 的视频模型属于 scenario-luma-video 技能的范畴。

连接方式和核心流程：请参阅此仓库中的 scenario 技能；与模型无关的图像操作（尺寸系列、蒙版、批处理字段）：请参阅 scenario-image 技能。如果此处提到的某个关联技能不在你的可用技能中，请让用户安装它 （npx skills add scenario-labs/skills --skill <name>）；在无人值守的情况下，请根据工具架构继续操作并指出这一缺失。

快速参考

模式由输入决定（名称取自实时架构）：

模式	输入	行为
创建	prompt（+ imageRef）	根据提示词生成完整场景；遵循 aspectRatio，默认值为 3:2
编辑	source + prompt（+ imageRef）	提示词描述要做的更改；除非设置了 aspectRatio，否则输出会保留源图比例

imageRef 是引导图像数组，可与 source 一起使用。各成员的上限不同：撰写本文时，Max 最多支持 9 张参考图，标准版支持 8 张；编辑时，源图占用其中一个名额。两者的 prompt 上限均为 6000 个字符，支持 9 种 aspectRatio，范围从 1:3 到 3:1，并支持 outputFormat png（默认值）或 jpeg。每张参考图都会增加成本，因此更改数量后请使用 dry_run 重新估算。webSearch（默认值为 false）会让模型在生成前获取真实世界的视觉资料：当提示词提到模型可能不熟悉的真实地点、产品或风格时，请启用此功能。不存在 seed、蒙版、像素尺寸或批次数量字段：尺寸仅由比例决定，蒙版编辑应使用其他模型，也无法固定相同的重复运行结果，因此每次迭代只改动一项内容。撰写本文时，尽管公开竞技场评分几乎相同，Max 档位生成一张 2K 图像的成本约为标准版的 2.5 倍，因此批量处理前请用 dry_run 在两个档位上运行相同任务。

参考图的作用取决于用途

只有在提示词中明确说明要从参考图中提取什么时，模型才会可靠地遵循参考图：角色相似度、风格、构图、调色板、光线、纹理或情绪。未标明用途的参考图会被模型自行猜测，而且没有遵循度滑块；提示词越具体，影响力越大（“使用第一张参考图中的确切配色和缝线”）。不同参考图的用途可以叠加，每张各司其职。在多轮迭代中重复使用同一张规范参考图，才能保持角色一致。

创建提示词描述场景，编辑提示词保留原样

创建提示词应使用自然语言描述一个场景：主体、环境、光线、情绪、风格，并且始终明确说明光线——这是影响质量的最大单一因素。对于图像中的文字，请将准确内容放在引号中；渲染文字是该系列的优势之一，而 Max 档位宣传的优势是能准确渲染非拉丁文字，并非普遍擅长拉丁文字。编辑提示词应精确克制：先说明更改，再明确哪些内容不能变动（“将 X 改为 Y。Z 必须保持原样。”）。每次运行只描述一个场景或一项更改。

实例：带有渲染标题文字的旅行海报

1. 使用 target="models"、query="luma uni"、public=true 调用 search。优先选择最新的 非弃用结果，例如 model_luma-uni-1-max（撰写时可用的结果；每次会话都要重新发现）。
2. 使用该 ID 调用 model_schema_get：首先查看参考图上限、比例列表和默认值。
3. 使用 upload_asset 上传调色板参考图（参见 scenario 技能），获取其资源 ID。
4. 使用该 model_id 和 dry_run=true 调用 model_run，并传入准确的 parameters={"prompt": "A travel poster of Kyoto in autumn, a pagoda above red maples, warm golden hour light, flat-print texture. Use the reference for color palette and print grain. The title text \"KYOTO\" in bold serif across the top.", "imageRef": ["asset_a"], "aspectRatio": "2:3", "webSearch": true} （提示词中提到了真实地点，因此要进行信息核验）。
5. 再次调用 model_run，并设置 wait=false，然后使用返回的任务 ID 调用 jobs_wait；若超时，则再次调用并传入 pending_job_ids。模型会在渲染前进行推理（撰写时的延迟中位数接近 90 秒），因此超时不代表失败，也绝不能因此再次调用 model_run。
6. 使用 asset_display 检查标题拼写和调色板，然后使用 asset_download 保存。

常见错误

• 将风格参考图作为 source 传入：这会将运行模式切换为编辑模式，输出也会紧贴参考图。参考图应放在 imageRef 中；source 仅用于指定要更改的图像。
• 参考图未标注：在提示词中说明每张参考图的用途，否则模型会猜测该参考哪张图。
• 编辑提示词中没有保留要求：未明确固定的内容都可能被更改。
• 默认会生成正方形图像：创建模式默认比例为 3:2，因此要明确设置 aspectRatio。
• 查找 seed、mask、width 或批次数量：撰写时这些参数都不存在；应查看 model_schema_get，不要想当然。
• 将 Max 版的参考图上限或价格套用到标准版：两者的字段名称相同，但数值不同。