必须先完成平台开通、模型授权和api密钥配置，否则上传参考图后点击生成会直接报错“unauthorized”；需开通doubao-seedream-5-0-pro-260713视觉模型、创建含“视觉模型调用”权限的api key、确认正确地域base url；参考图须为公网https直链，支持单图或1～5张url列表；提示词需明确区分保留项与变更项；调用支持daft dataframe或http post方式，注意reference_images为空时自动降级为文生图；lumina平台支持手绘框选区域加@标签进行局部编辑。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在火山引擎上用一张或多张参考图生成符合新提示词要求的图像，必须先完成平台开通、模型授权和API密钥配置，否则上传参考图后点击生成会直接报错“Unauthorized”。
开通视觉模型并获取调用凭证
登录火山方舟管理控制台 → 进入「开通管理」→ 点击「视觉模型」→ 勾选 doubao-seedream-5-0-pro-260713（当前最新商用版）并开通；【未开通对应视觉模型，即使API Key正确也无法调用图生图功能】
在「API Key 管理」中创建新Key，权限至少勾选「视觉模型调用」；复制该Key值，后续将作为请求头中的 Authorization 字段值。
确认当前地域对应的Base URL，例如华东2（上海）为 https://las.volcengine.com ，不同地域URL不可混用，填错会导致404或502错误。
准备参考图与提示词
参考图需为公网可访问的HTTPS链接，支持JPG/PNG/WebP格式，单张不超过10MB；若本地图片，须先上传至图床或OSS并获取直链。
reference_images 字段支持三种输入形式：None（纯文生图）、单个字符串URL（图生图）、字符串列表（多图融合），多图时建议控制在1～5张，超过7张易触发内存超限熔断。
提示词（prompt）需明确区分“保留项”与“变更项”，例如“保留原图中穿红裙的女性姿态和光影，将背景改为雨天东京涩谷十字路口，添加霓虹灯牌文字‘LUMINA’”——模糊写成“一个女人在东京”会导致主体结构坍塌。
调用图生图接口（Daft方式）
方法一：使用 Daft DataFrame 构造输入表
导入 daft；创建含两列的DataFrame：prompt 列填字符串，reference_images 列填单个URL字符串或URL列表；调用 .map_batches() 加载 doubao-seedream-5-0-pro-260713 算子，传入参数 response_format="url" 和 guidance_scale1=7.5、guidance_scale2=9.0（后者越高越忠于参考图）。
方法二：直接发送HTTP POST请求
向 BaseURL + /api/v1/visual/generate 发起POST；Headers 中设置 Content-Type: application/json 和 Authorization: Bearer ；Body 中必须包含 prompt、reference_images、model_id="doubao-seedream-5-0-pro-260713"，可选添加 seed=42 固定随机种子。
注意：若 reference_images 是空列表 [] 或 None，接口将自动降级为文生图模式，不会报错但结果与预期不符。
在Lumina平台手绘式图生图（交互编辑）
第一步：打开 Lumina 平台 → 选择「Image Generation」→ 模型切至 Seedream 5.0 Pro → 点击「Upload Image」上传参考图。
第二步：鼠标悬停图上 → 点击浮出的【Draw】按钮 → 选择【框选】工具，在需要重点保留或修改的区域拖出一个矩形 → 系统自动生成 @Region01 标签。
第三步：在Prompt输入框中写“@Region01 区域替换为毛玻璃质感金属面板，保留原有光照角度和接缝走向”，回车生成；【不加 @ 符号直接写‘区域替换为…’，模型将忽略定位意图，整图重绘】
第四步：生成结果右侧自动展开图层面板，可单独下载 @Region01 对应的局部重绘图层（PNG透明底），无需PS抠图。
