跳转至

GriptapeCloudImage 统一云端图像生成驱动配置节点

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

GriptapeCloudImage 驱动节点专用于在 Griptape 流程中建立与 Griptape Cloud 官方托管图像生成服务的通信管道与画质超参数预设。

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

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

  • 直接依托 Griptape 官方统一账户生成高质量 AI 图像（免去独立注册和绑定多个海外第三方生图平台 API 密钥的繁琐流程）；
  • 通过 Griptape 统一平台调用 DALL-E 3 或其他前沿图像生成底座；
  • 为生图节点定制画幅分辨率比例、艺术渲染风格与生成精度品质。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

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

参数输入插槽 (Parameters)

  • model：目标生图模型标识符（默认 "gpt-image-1-mini"）。
  • image_size：生成图像的目标物理分辨率与画幅比例（默认 "1024x1024" 正方形画幅，亦支持长宽自定义选择）。
  • style：艺术渲染风格倾向：
    • natural（自然写实）：呈现贴近真实摄影的光影质感、柔和对比与细腻肌理；
    • vivid（生动戏剧）：增强画面色彩饱和度、高反差明暗与戏剧性构图张力。
  • quality：图像生成精度与细节采样级别：
    • standard：标准解析度（生成速度更快）；
    • hd：高清晰度（更丰富的毛发、微小纹理与细节表达）。

输出引脚 (Outputs)

  • image_model_config：打包封装就绪的 Griptape Cloud 图像模型驱动配置对象，供下游生图节点消费。

典型工作流示例 (Example)

配置竖屏高解析度生图驱动：

  1. 添加 GriptapeCloudImage 节点至画布。
  2. 将 image_size 调整为 "1024x1792" 适配移动端壁纸与社交媒体海报。
  3. 将 style 切换为 "vivid" 增强视觉震撼力。
  4. 将该节点的 image_model_config 输出连接至 GenerateImage 节点的同名输入端。
  5. 后续触发的所有生图任务均将严格应用上述配置规格。

关键技术特性 (Important Notes)

  • 统一云凭证：依赖运行环境中的有效 Griptape 密钥（环境变量 GT_CLOUD_API_KEY；在 Griptape Nodes 原生环境中通常已自动配置就绪）。
  • 分辨率自适应：节点会自动根据所选的具体底层模型限制对图像分辨率进行合法性适配校准。
  • 默认驱动说明：该驱动是 GenerateImage 节点的内置默认生图驱动，直接接入若保持默认参数将与缺省配置效果一致。