---
name: xiakeyun-image
description: 通过虾壳云生成图片并自动按用户需求适配尺寸。适用于生成图片、海报、壁纸、头像、横图、竖图、封面等场景。技能会根据用途自动选择合适分辨率并生成图片文件。
---

# xiakeyun-image

使用这个技能为用户生成图片。

## 快速流程

1. 从用户请求中提取：
   - 图片提示词
   - 预期尺寸或用途
   - 格式要求（png/jpeg/webp）
   - 质量要求（low/medium/high/auto）
   - 张数
2. 根据用途自动映射尺寸：
   - 头像、图标、logo、方图 -> `1024x1024`
   - 横版配图、banner、PPT配图、16:9 -> `1536x1024`
   - 海报、手机壁纸、小红书封面、9:16 -> `1024x1536`
   - 明确要求 2K / 4K 时，优先映射到对应官方尺寸
   - 未说明时用 `auto`
3. 运行 `scripts/generate_image.py`。
4. 把生成出的文件路径返回给上层流程，必要时再交给图片发送或附件流程。

## 命令模板

在技能目录下运行：

```bash
python scripts/generate_image.py --prompt "<提示词>" --size "<可选尺寸>" --quality auto --format png --n 1 --outdir outputs
```

## 参数规则

- `--prompt`：必填。
- `--size`：可留空，让脚本自动推断。
- `--quality`：默认 `auto`；仅允许 `low|medium|high|auto`。
- `--format`：默认 `png`；仅允许 `png|jpeg|webp`。
- `--n`：1-10。
- `--outdir`：输出目录，默认 `outputs`。

## 尺寸理解规则

如果用户这样说，按下面理解：

- “头像、logo、图标、1:1、方图” -> 正方形
- “公众号头图、banner、PPT配图、横版、16:9” -> 横图
- “海报、手机壁纸、9:16、竖版、小红书封面” -> 竖图
- “2K、4K” -> 使用更高分辨率官方尺寸

如果用户直接给出官方支持尺寸，则原样使用。

## 安全与保密

- 不要在对外回复中暴露 API 基础地址。
- 不要要求用户手动输入密钥。
- 默认从环境变量读取虾壳云 API key。
- 若缺少密钥，仅说明“当前环境未配置虾壳云密钥”，不要输出猜测的变量值或底层地址。

## 参考资料

需要确认字段或尺寸规则时，读取 `references/api.md`。
