GrokImage 生图驱动配置与 xAI 图像模型连接节点
节点核心功能 (What is it?)
GrokImage 驱动节点专用于在 Griptape 流程中建立与 xAI Grok 官方生图服务（如 Grok 图像生成模型）的通信连接，为工作流注入由 xAI 驱动的文生图能力。
典型适用场景 (When would I use it?)
在以下情况下使用该节点：
- 在自动化管线中直接调用 xAI Grok 的图像生成模型；
- 根据自然语言文本提示词（Prompts）生成富有艺术张力的视觉图像；
- 将 xAI 专有的视觉审美与概念构图风格引入您的生图流水线中。
使用指南 (How to use it)
基础配置流程 (Basic Setup)
- 在工作流画布中添加 GrokImage 节点。
- 将其输出引脚连接至下游能够执行生图计算的节点（例如
GenerateImage节点）。
参数输入插槽 (Parameters)
- model：目标生图模型版本（默认推荐
"grok-2-image-1212"）。
输出引脚 (Outputs)
- image_model_config：组装完成的 Grok 图像驱动配置工件，供 downstream 生图节点直接消费。
典型工作流示例 (Example)
为生图节点挂载 Grok 生图底座：
- 添加 GrokImage 节点至工作流画布。
- 确认
model选定为所需的 Grok 图像模型版本。 - 将该节点的
image_model_config输出引脚连入GenerateImage节点的同名输入插槽。 - 此时
GenerateImage节点即会调用 xAI Grok 的后端生成高质量图像。
关键技术特性 (Important Notes)
- API 凭据依赖：需要在运行环境中配置有效的 Grok API 密钥（环境变量
GROK_API_KEY，可在 xAI 控制台 申请获取）。 - 轻量封装特性：该节点作为对 xAI 生图能力的轻量封装，保持了高吞吐与高协议保真度。
常见问题与排查 (Common Issues)
- 缺少 API Key：请在系统环境变量或设置中确认
GROK_API_KEY已经正确填写。 - 账单与额度限制：调用 xAI 接口前请确保该账户已成功绑定计费支付卡，并留有充足的可用额度。