跳转到内容
MagicAI 工作流 MagicAI 工作流

AI 图片生成

AI 图片生成 用于把文字描述或参考图转成图片素材。它属于桌面端本地内置能力，出现在指令树的「常用智能能力 / AI 创作」中，拖到画布后可直接配置提示词、模型、分辨率和输出位置。

先选使用方式

Section titled “先选使用方式”
方式怎么用适合人群
可视化编排（推荐）在「常用智能能力」中拖入 AI 生图，填写提示词并运行需要快速生成素材的用户
代码编排（执行指令 XML）通过「执行指令（XML）」动态调用 AIImageGenerate需要批量生成、循环生成或动态拼参数的用户

什么时候用？

Section titled “什么时候用？”
  • 根据商品、活动、文章或任务说明生成配图。
  • 用参考图做图生图，生成相同主题的新版本。
  • 批量生成多张候选图，供后续筛选或保存。

使用前确认

Section titled “使用前确认”
  • 桌面端本地引擎需要可用，并且已配置可访问的 AI 生成服务。
  • 文生图必须填写 prompt；图生图还需要填写 images。
  • 输出文件会下载到本地目录，建议确认磁盘权限和保存路径。
AI 图片生成

可视化编排：从 0 到跑通

Section titled “可视化编排：从 0 到跑通”
  1. 打开工作流编辑器，在指令树顶部找到「常用智能能力」。
  2. 展开「AI 创作」，拖入 AI 生图。
  3. 在 提示词 中填写画面描述，例如：
一张极简风格的产品宣传图，白色背景，主体居中，柔和光影
  1. 选择模型和分辨率，必要时上传参考图。
  2. 运行节点，在输出变量中查看 images、localPath、model、size 等字段。

参数说明

Section titled “参数说明”

输入参数

Section titled “输入参数”
界面名称代码属性名类型必填默认值说明
提示词promptString是-描述要生成的画面。文生图必填。
模型modelString否seedream-4.0可选择常用模型，也可输入网关支持的新模型。
生成模式modeEnum否text-to-imagetext-to-image 为文生图，image-to-image 为图生图。
参考图imagesFile / URL否-图生图输入图，可多选本地图片，也可填写 URL。
分辨率sizeString否模型默认例如 1024x1024、1920x1080。
生成数量countNumber否1一次生成图片数量。
随机种子seedString / Number否-用于尽量复现结果，取决于模型支持情况。
输出目录outDirDirectory否默认输出目录生成图片下载保存的位置。
将结果保存至outKeyOutput是当前节点保存生成结果，供下游引用。

输出参数

Section titled “输出参数”
字段类型说明
imagesArray图片数组，每项包含 url、localPath、revisedPrompt。
countNumber实际生成数量。
modeString实际生成模式。
modelString实际使用的模型。
sizeString实际出图分辨率。
seedNumber使用的随机种子，未填写时可能为空。

成功标准

Section titled “成功标准”
  • 节点运行成功，没有 API Key、模型或网络错误。
  • 输出变量中存在 images 数组。
  • 至少一项 images[].localPath 指向本地生成文件。

失败排查

Section titled “失败排查”
报错 / 现象可能原因处理建议
AIImageGenerate requires "prompt"未填写提示词填写清晰的画面描述。
NEWAPI_API_KEY 未配置未配置生成服务鉴权检查桌面端环境配置或系统变量。
NEWAPI_BASE_URL 未配置未配置生成服务地址配置可访问的 AI 网关地址。
image-to-image 模式需要 images/image 参数选择图生图但未填参考图上传本地图片或填写图片 URL。
API 返回空数据模型服务没有返回图片更换模型、缩短提示词或重试。

代码编排

Section titled “代码编排”
<AIImageGenerate
  prompt="一张极简风格的产品宣传图，白色背景，主体居中"
  model="seedream-4.0"
  size="1024x1024"
  count="1"
  outKey="imageResult"
/>

相关指令

Section titled “相关指令”