用途:面向新集成,使用 Luma Agents API(ray-3.2)进行视频生成、视频编辑与画面重构,避免与消费者 Luma App 及旧版 Dream Machine API 混用。
主要能力:基础地址 https://agents.lumalabs.ai/v1,凭据 LUMA_AGENTS_API_KEY 以 Bearer 发送(当前以 luma-api- 开头)。POST /v1/generations 支持 type 为 video、video_edit、video_reframe,GET /v1/generations/{id} 轮询。文本生视频、图生视频、前后向延长;视频编辑保留或重释源运动;重构改目标宽高比。分辨率含 360p 草稿、540p、720p(默认)、1080p,输出 MP4,标准时长 5 或 10 秒。
用法要点:锚点与多关键帧通过 video.start_frame/end_frame 或 video.keyframes 加 video.keyframe_indexes 提供;loop、HDR、EXR、延长各有互斥与时长/分辨率约束;编辑从 auto_controls 开始,可换九个强度值或逐信号控制;重构仅 SDR 且源每通道不超过 30 秒。
限制:公开 API 无 seed 与负向提示词;输出 URL 预签名一小时,需及时下载;文档存在若干冲突(如关键帧上限 16 与 64、编辑时长 18 与 30 秒),应以当前 schema 为准并复核。旧 Dream Machine API 未公布下线日期,仅作遗留维护。
定价:按 Agents 定价指南执行,付费前核对价位、时效与账户限制;预付费与付费运行前应建立审批记录并做干跑。未在资料中明确的内容暂未提供。