Microsoft Foundry image generation

核心用法

Azure Foundry Image Generation 技能是面向 OpenClaw 工作流的轻量级图像生成封装器，通过调用 Azure AI Foundry（原 Cognitive Services）的图像生成 REST API，将文本提示转换为 PNG/JPEG 图像。该技能采用纯 Shell 实现，依赖 curl、jq 和 base64 三大标准工具，无需额外运行时环境。

典型工作流包含三步：配置终端节点（FOUNDRY_ENDPOINT）、设定部署名称（如 FLUX-1.1-pro 或 DALL-E 3）与 API 密钥，最后通过 JSON payload 提交生成请求。技能设计上强调安全性——使用 jq --arg 进行参数转义，避免 Shell 注入；采用流式 base64 解码而非变量存储，防止内存溢出风险。

显著优点

• 企业级集成：原生支持 Azure AD 与 RBAC 权限体系，API 密钥可纳入 Azure Key Vault 轮转策略
• 模型灵活性：通过 FOUNDRY_DEPLOYMENT 变量切换不同模型（OpenAI DALL-E、Stable Diffusion、FLUX 等），无需修改代码
• 轻量无依赖：仅依赖系统标准工具，适合容器化/边缘计算场景
• 安全传输：强制 HTTPS 验证，支持 API 版本锁定（默认 2025-04-01-preview）

潜在局限

• 网络依赖：必须能够访问 Azure 认知服务终端节点，无法离线运行
• Shell 环境限制：Windows 用户需 WSL 或 Git Bash 环境，原生 PowerShell 不支持示例语法
• 响应处理粗糙：仅提取首帧图像（.data[0]），批量生成需自行扩展
• 无内置重试机制：curl --fail 遇 5xx 错误直接退出，生产环境建议包装重试逻辑
• 成本不可见：未封装额度查询或成本估算接口，超额使用可能导致账单风险

适合人群

• 已采用 Azure 生态的企业 DevOps/SRE 团队
• 需要将图像生成嵌入 CI/CD 流水线或自动化脚本的工程师
• 对数据驻留有合规要求、不愿使用公共 API 端点的组织

常规风险

| 风险类别 | 说明 | 缓解建议 |

|---------|------|---------|

| 密钥泄露 | API Key 以明文环境变量传递 | 使用临时凭证或 Azure Managed Identity |

| 提示注入 | 未对 `$PROMPT` 做内容安全过滤 | 前置 Azure Content Safety API 检测 |

| 终端节点欺骗 | URL 验证仅检查格式，不校验证书域名 | 部署私有 DNS 与证书固定策略 |

| 资源耗尽 | 无速率限制，高频调用导致成本激增 | 配置 Azure API Management 层限流 |

核心用法

ms-foundry-image-gen 是一个纯文档型 Skill，用于指导用户通过环境变量配置 Azure Foundry（认知服务/OpenAI）的图像生成端点，并调用 REST API 生成 PNG/JPEG 图像。用户需设置 FOUNDRY_ENDPOINT、FOUNDRY_API_KEY、FOUNDRY_DEPLOYMENT 三个必填环境变量，可选配置 FOUNDRY_API_VERSION。

示例流程：验证端点 URL → 构造 API 请求 → 使用 curl 发送 POST 请求 → 流式解析 base64 响应 → 解码保存图像。Skill 本身不执行代码，仅提供安全实践示例（jq --arg 防注入、流式处理避免大变量）。

显著优点

1. 零本地依赖：无可执行代码，纯 Markdown 文档，不消耗本地计算资源
2. 安全示例完善：包含 URL 格式校验、jq 参数化防注入、流式 base64 解码等最佳实践
3. 灵活对接官方服务：直接调用微软 Azure 官方 API，无需中间层
4. 透明开源：代码托管于 GitHub，作者身份可验证，无黑箱操作

潜在缺点与局限性

• T3 来源可信度：个人开发者维护，缺乏企业级 SLA 保障
• 环境配置门槛高：需自行准备 Azure 订阅、创建认知服务资源、获取 API 密钥
• 无内置重试/限流：示例代码未包含错误重试、指数退避、速率限制处理
• 临时文件风险：默认写入 /tmp，多用户环境需注意权限隔离
• 成本不可控：图像生成按调用计费，无预算上限保护

适合人群

• 已拥有 Azure 订阅、熟悉云资源管理的开发者
• 需要在自动化工作流（OpenClaw）中集成图像生成的团队
• 具备 shell 脚本基础、能独立排查网络/认证问题的用户
• 不适合：无 Azure 经验、追求开箱即用、或对 T3 来源有合规限制的企业环境

常规风险

| 风险点 | 说明 | 缓解建议 |

|--------|------|----------|

| API 密钥泄露 | 环境变量注入，无加密存储 | 使用 Azure Key Vault，定期轮换密钥 |

| 端点欺骗 | 依赖用户正确配置 `FOUNDRY_ENDPOINT` | 白名单校验域名，拒绝非标准 Azure 域 |

| 敏感内容生成 | 提示词未经内容安全审核 | 前置 Azure Content Safety 或人工审核 |

| 费用失控 | 无调用量上限 | 配置 Azure 预算警报，监控成本 |

| 临时文件残留 | `/tmp` 文件可能含敏感提示词 | 及时清理，使用专用临时目录 |