用途：通过 Luma AI 一方 Photon/Photon Flash 图像 API 完成文生图、参考图引导与图像修改。可用的图像模型 ID 为 photon-1（默认、偏高质量）与 photon-flash-1（更快、成本更低），应据实际交付物做对比测试后再选型。
主要能力：支持 prompt 文本生成；aspect_ratio 可选 1:1、16:9、9:16、4:3、3:4、21:9、9:21，默认 16:9；format 可选 jpg 或 png，默认 jpg；image_ref、style_ref 传 {url, weight} 数组做概念/风格引导；character_ref 使用 identity0 承载同一身份的多张图片；modify_image_ref 传一张图做定向修改；可选 callback_url 接收状态回调。官方未提供 seed、负向提示、mask、guidance scale、步数等参数，请勿假定或编造。
使用方式：向 POST https://api.lumalabs.ai/dream-machine/v1/generations/image 发送 JSON，携带 Authorization: Bearer $LUMAAI_API_KEY 与 Content-Type: application/json；管理与查询路由包括 GET /dream-machine/v1/generations/{id}、GET /dream-machine/v1/generations?limit=100&offset=0、DELETE /dream-machine/v1/generations/{id}、GET /dream-machine/v1/credits。官方 Python 包为 lumaai，图像创建走 client.generations.image.create(...)，轮询用 client.generations.get(id=...)。异步任务状态含 queued、dreaming、completed、failed，需有截止时间与退避轮询；完成后立即将产物转入可控存储。
适用场景：需要以编程方式批量或编排生成图像的工程化场景，尤其是参考图引导、风格迁移与局部修改任务。
限制：Photon 仅接受 Luma 服务器可抓取的 URL 作为参考输入，不记录鉴权抓取头；同一次创建只返回一个图像产物，变体需另行发起请求；官方未公布幂等键、输出保留期、数据驻留或单次计费字段；参考只有条件化作用，不能保证身份、logo、排版或未改区域完全一致。文档存在冲突（如参考图数量上限、sync 参数与轮询、Flash 价格），生产前应重新核对一方参考与账单。