| name | azure-image-gen |
| description | 使用 Azure OpenAI gpt-image-1 模型生成图片。当需要为诗歌、文章或任何内容创建配图时使用此技能。支持根据文本描述生成高质量图片并保存为本地文件。触发条件：用户要求生成图片、需要配图、创建插图、AI绘画。 |
Azure OpenAI 图片生成 Skill
使用 Azure OpenAI 的 gpt-image-1 模型，根据文本描述生成高质量图片。
前置要求
- 已部署 Azure OpenAI
gpt-image-1 模型
- 在 Skill 目录下配置
.env 文件（参考 .env.example）
- 已安装 Python 3.10+ 和
openai 包
环境配置
在 .github/skills/azure-image-gen/.env 中配置以下变量：
AZURE_OPENAI_ENDPOINT=https://<your-resource>.openai.azure.com/
AZURE_OPENAI_API_KEY=<your-api-key>
AZURE_OPENAI_DALLE_DEPLOYMENT=gpt-image-1
AZURE_OPENAI_API_VERSION=2025-04-01-preview
使用方式
当需要生成图片时，运行 Skill 目录中的 generate_image.py 脚本：
cd .github/skills/azure-image-gen
python generate_image.py --prompt "描述文本" --output "../../../output/image.png"
参数说明
| 参数 | 必填 | 默认值 | 说明 |
|---|
--prompt | 是 | - | 图片描述（支持中英文） |
--output | 否 | ./output.png | 输出文件路径 |
--size | 否 | 1024x1024 | 图片尺寸（1024x1024、1024x1536、1536x1024） |
--quality | 否 | high | 图片质量（low、medium、high） |
与诗人Agent配合使用
当诗人Agent判断需要配图时，按以下步骤操作：
- 从诗人Agent的输出中获取「配图描述」
- 将描述作为
--prompt 参数传入脚本
- 对于中文描述，脚本会自动处理
示例：
python .github/skills/azure-image-gen/generate_image.py \
--prompt "春日江南水乡，柳树依依，桃花盛开，燕子飞舞，池塘碧波荡漾，中国水墨画风格" \
--output "./output/spring.png" \
--size "1024x1024" \
--quality "high"
注意事项
- 生成图片需要消耗 Azure OpenAI 的配额
- 确保
.env 文件已添加到 .gitignore，避免泄露密钥
- 推荐在 prompt 中加入画风描述（如"中国水墨画风格"、"水彩风格"）以获得更好效果
