跳转至

OpenAiImage 生图驱动配置与 DALL-E 图像模型直连节点

节点核心功能 (What is it?)

OpenAiImage 驱动节点专用于在 Griptape 流程中建立与 OpenAI 官方图像生成服务（如 DALL-E 3、DALL-E 2）的直连通道，允许您从自然语言文本提示词直接生成专业数字艺术作品或写实照片。

典型适用场景 (When would I use it?)

在以下情况下使用该节点：

  • 直接调用 OpenAI 官方最新的 DALL-E 3 系列模型生成高质量图像；
  • 将自然语言文案与 Prompt 转换为直观生动的视觉插画或逼真照片；
  • 精细控制 DALL-E 3 的画面纵横比、艺术风格、细节采样精度以及安全审核过滤强度。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

  1. 在工作流画布中添加 OpenAiImage 节点。
  2. 将其输出引脚连接至需要生图驱动的节点（例如 GenerateImage 节点）。

参数输入插槽 (Parameters)

  • model：目标 DALL-E 模型标识符（默认 "dall-e-3"）。
  • image_size：生成图像的物理像素画幅规格（默认 "1024x1024" 正方形，DALL-E 3 亦支持 "1024x1792" 竖屏或 "1792x1024" 横屏）。
  • style：艺术渲染风格：
    • natural（自然写实）：呈现真实的物理光影、柔和的反差与逼真的材质质感；
    • vivid（生动戏剧）：色彩明艳浓郁、动态范围宽广、具有极强超现实主义张力。
  • quality：画面质量级别：
    • standard：标准渲染精度（推理较快，消耗成本较低）；
    • hd：高清晰度精度（画面细节更细致、线条更平滑）。
  • background：背景生成策略预设选项。
  • moderation：安全合规审核模式（standard 或 strict，用于调节对敏感内容的过滤强度）。
  • output_format：图像编码格式（png 或 jpeg）。

输出引脚 (Outputs)

  • image_model_config：打包封装就绪的 OpenAI 图像模型驱动配置对象，供 downstream 生图节点直接消费。

典型工作流示例 (Example)

配置 DALL-E 3 电影级高清横屏生图驱动：

  1. 添加一个 OpenAiImage 节点至画布。
  2. 配置关键参数：
    • 将 model 选为 "dall-e-3"；
    • 将 image_size 设为 "1792x1024"（16:9 宽屏宽幅画幅）；
    • 将 style 切换为 "natural" 营造胶片真实感；
    • 将 quality 设为 "hd" 强化微观细节。
  3. 将该节点的 image_model_config 输出引脚连接至 GenerateImage 节点。
  4. 运行 GenerateImage 即可按上述高清标准渲染输出精美大图。

关键技术特性 (Important Notes)

  • 官方凭据管理：需要在运行环境中配置有效的 OpenAI 官方密钥（环境变量 OPENAI_API_KEY）。
  • DALL-E 3 规格约束：DALL-E 3 仅严格支持 1024×1024、1024×1792 和 1792×1024 三种官方预定义分辨率。

常见问题与排查 (Common Issues)

  • 缺少 API Key：确认环境已正确挂载 OPENAI_API_KEY。
  • API 速率限制 (Rate Limits)：DALL-E 3 接口在并发调用或短时间频繁生成时有较为严格的每分钟请求数（RPM）限制，如遇 429 错误请合理设置重试延迟。