67 lines
2.1 KiB
Markdown
67 lines
2.1 KiB
Markdown
---
|
||
name: generate-image
|
||
description: 文生图（Qwen-Image）。根据提示词生成图片并保存为本地 PNG 文件；需要配置 DASHSCOPE_API_KEY，可选配置 DASHSCOPE_IMAGE_API_URL。生成后可用 deliver_artifacts 发送到 IM。
|
||
system: true
|
||
handler: system
|
||
tool-name: generate_image
|
||
category: System
|
||
priority: high
|
||
---
|
||
|
||
# generate_image - 文生图（Qwen-Image）
|
||
|
||
使用通义百炼 Qwen-Image 系列模型（如 `qwen-image-max`）根据提示词生成图片，并自动下载保存为本地 PNG 文件。
|
||
|
||
## 前置条件
|
||
|
||
- 环境变量：`DASHSCOPE_API_KEY`（与通义其它模型共用）
|
||
- 可选：`DASHSCOPE_IMAGE_API_URL`
|
||
- 北京地域（默认）：`https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation`
|
||
- 新加坡地域：`https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation`
|
||
|
||
（API 参考：`https://help.aliyun.com/zh/model-studio/qwen-image-api`）
|
||
|
||
## 用法
|
||
|
||
```json
|
||
{
|
||
"prompt": "一张极简风格的产品海报，白色背景，中心是一只橘猫的线稿，标题“OPENAKITA”",
|
||
"model": "qwen-image-max",
|
||
"size": "1328*1328",
|
||
"prompt_extend": true,
|
||
"watermark": false
|
||
}
|
||
```
|
||
|
||
## 参数
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
|---|---|---|---|
|
||
| prompt | string | 是 | 正向提示词 |
|
||
| model | string | 否 | 模型名，默认 `qwen-image-max` |
|
||
| negative_prompt | string | 否 | 反向提示词 |
|
||
| size | string | 否 | 分辨率，格式 `宽*高`，默认 `1664*928` |
|
||
| prompt_extend | boolean | 否 | 是否开启提示词智能改写，默认 true |
|
||
| watermark | boolean | 否 | 是否加水印，默认 false |
|
||
| seed | integer | 否 | 随机种子 |
|
||
| output_path | string | 否 | 输出路径；不填会落到 `data/generated_images/` |
|
||
|
||
## 返回值
|
||
|
||
返回 JSON 字符串，包含：
|
||
- `saved_to`: 本地 PNG 路径
|
||
- `image_url`: 临时图片 URL（通常 24 小时有效）
|
||
|
||
## 发送到 IM（可选）
|
||
|
||
生成后如需发送图片到聊天，请调用 `deliver_artifacts`：
|
||
|
||
```json
|
||
{
|
||
"artifacts": [
|
||
{"type": "image", "path": "data/generated_images/xxx.png", "caption": "生成的图片"}
|
||
]
|
||
}
|
||
```
|
||
|