用首尾画面定义镜头走向
除了文字描述，luma 还可接收首帧与尾帧图片链接，让创作从具体画面出发。首帧用于建立起始构图，尾帧用于表达结束状态，提示词补充主体动作、环境变化和镜头意图。适合已有视觉稿、希望进一步探索动态表现的任务。
规格与接口特性
在选型前明确容量、输入输出与调用方式。
- 创作输入
- 文字提示词；首帧与尾帧图片链接
- 生成操作
- generate 新建视频；extend 继续生成
- 画幅控制
- 支持 aspect_ratio；常用画幅包括 16:9、9:16、1:1
- 续写依据
- 生成视频的 video_id 或 video_url；可附加尾帧
- 效果控制
- 循环开关 loop；清晰度增强开关 enhancement
- 任务处理
- 支持异步提交、任务查询与回调
- 结果交付
- 视频链接、视频 ID、尺寸、缩略图与任务状态
以上为 luma 入口的创作与调用规格，不代表所有 Ray 系列原生版本的功能范围。
核心能力
了解 luma 能为你的工作带来什么。
沿已有片段继续创作
当生成片段值得保留但内容尚未展开时，可用 extend 继续创作，而不必重新从文字开始。提交该片段的视频 ID 或链接，再描述后续动作；也可增加尾帧表达下一段的结束画面。这种方式便于分段探索镜头发展的不同方向。
把视频创作接入任务流程
luma 提供画幅、循环和清晰度增强控制，也支持异步提交与任务跟踪。应用可先保存任务 ID，再查询结果或接收回调，将完成的视频链接和缩略图送入素材列表。对需要在生成期间继续处理其他工作的创作工具尤其实用。
适用场景
从具体任务出发，找到模型发挥作用的位置。
让产品视觉稿动起来
以产品场景图作为首帧，结合展示动作、环境氛围和镜头方向的文字说明，生成动态展示素材；若已有结束构图，可同时提供尾帧。交付的视频与封面可进入营销素材候选库，供团队筛选，再配合剪辑、字幕和品牌包装完成制作。
探索分镜中的动作变化
把分镜起始画面与结束画面作为输入，说明人物或物体如何移动、场景如何变化，用生成结果观察两个视觉状态之间的动态表达。需要延展创意时，再以生成片段继续创作。适合制作概念预演和镜头提案，而非直接替代精确动画制作。
制作多画幅动态素材
围绕同一创意分别选择横屏、竖屏或方形画幅，输入适合对应构图的提示词与参考画面，生成用于不同展示位置的素材。背景动画可尝试循环控制；系统保存任务状态、视频链接与缩略图，方便编辑人员查看候选结果并组织后续交付。
如何选择这个模型
结合任务复杂度、输入材料与预期结果选择。
重视画面起点与续写时选择
如果手里已有静态视觉稿，或者希望在生成片段上继续发展动作，luma 的首尾帧与扩展流程更贴近这类任务。仅有文字构想时可先新建视频，明确视觉方向后再加入参考画面。选择时应关注画面约束与分段创作需求，而不是只比较型号名称。
与明确版本的 Ray 产品区分
luma 是服务入口名称，不等同于 Ray2、Ray3 或 Ray3.2 的固定版本。若项目明确要求多关键帧、HDR 或特定视频修改方式，应选择明确支持这些功能的产品；若核心需求是文字生成、首尾帧引导和已有片段续写，则可围绕 luma 的这些工作流组织创作。
开始使用
从一次小规模任务到正式接入。
准备任务与材料
明确目标、必要输入与输出要求，使用真实业务样例作为起点。
在 API 调试区试用
打开试用页，确认此入口支持的参数，再提交小规模任务查看结果。
按 API 文档接入
保留完整模型 ID，使用文档规定的请求格式，并在 Pricing 页确认计费规则。
使用边界
在正式使用前，了解输出质量与能力范围。
- 首尾帧提供的是画面引导，不应当作逐帧动画控制。需要准确还原产品细节、文字标识或人物动作时，应逐段检查生成结果；对必须精确落位的字幕、商标和图形，宜在后期制作中单独处理。
- 视频扩展适合继续生成已有片段，并不等于任意视频的全面编辑。操作时应提供可用的视频 ID 或链接，并描述后续内容；不要把续写功能理解为剪切、局部替换、配音或完整时间线编辑。
- 画幅选择与清晰度增强不是固定分辨率保证，超时设置也不是完成时间承诺。制作流程应根据返回的尺寸和任务状态处理素材；长时间任务宜采用异步方式，避免把持续等待绑定在交互页面上。
常见问题
解答使用 luma 时的常见疑问。
luma 就是最新的 Ray 型号吗？
不是这样的命名关系。luma 是视频服务入口名称，不能直接等同于某个固定 Ray 版本。使用时可围绕文字生成、首尾帧控制和视频续写安排任务；若需要某一 Ray 版本的专属功能，应选择明确支持该功能的产品。
可以同时指定首帧和尾帧吗？
可以通过 start_image_url 和 end_image_url 提供图片链接，再用 prompt 描述中间希望发生的动作与变化。只提供首帧也能开始创作。两张图片适合表达镜头的起止状态，但中间过程仍由生成完成，不是逐帧指定。
怎样继续生成已经完成的视频？
将 action 设为 extend，提供已生成视频的 video_id 或 video_url，并写入后续内容的提示词。若希望续写落到指定画面，还可加入 end_image_url。应保存每次生成返回的新视频信息，方便后续继续创作与素材管理。
循环和清晰度增强分别有什么作用？
loop 用于请求循环视频，enhancement 用于控制清晰度增强；它们分别服务于播放方式和视觉处理，不应混为一项功能。制作动态背景时可尝试循环，并检查衔接效果；开启增强也不意味着承诺某个固定输出分辨率。
提交之后必须一直等待视频完成吗？
不必。可设置 async=true，先取得 task_id，再通过任务查询获取状态和结果；也可使用 callback_url 接收完成通知。任务 ID 用于关联这次创作，视频 ID 用于标识生成素材，两者应分别保存，避免在后续扩展时混用。
模型资料 · 更新日期：2026-10-01。调用参数与计费规则请查看 API 和定价栏目。