init: AI 文生图调用脚本与文档
- gpt-image-t2i / grok-image-t2i:OpenAI 兼容接口文生图脚本 - SKILLS.md:输出规范(统一输出到 output/,按「模型名-时间戳」命名) - 接口与参数说明文档
This commit is contained in:
@@ -0,0 +1,54 @@
|
||||
# Skills
|
||||
|
||||
本目录提供了调用 AI 文生图接口(text-to-image)的 Python 脚本,供其他 Agent 直接调用,无需自己实现 API 逻辑。
|
||||
|
||||
## 可用脚本
|
||||
|
||||
| 能力 | 脚本路径 | 模型 | 说明 |
|
||||
|------|----------|------|------|
|
||||
| GPT 绘图 | `gpt-image-t2i/generate_image.py` | `gpt-image-2-2K` | 通过 OpenAI 兼容接口生成图片 |
|
||||
| Grok 绘图 | `grok-image-t2i/generate_image.py` | `grok-imagine-image-lite` | 通过 xAI 兼容接口生成图片 |
|
||||
|
||||
两个脚本共用同一个 OpenAI 兼容接口:`https://api.slomerex.xyz/v1/images/generations`,API Key 已硬编码在各自脚本中,Agent 无需处理鉴权。
|
||||
|
||||
## 输出规范(所有 Agent 必须遵守)
|
||||
|
||||
- **输出目录**:本技能产生的所有文件(生成的图片等)统一保存到项目根目录的 `output/` 文件夹中,不要输出到其他位置。
|
||||
- **图片命名格式**:每次生成的图片统一按 `{调用的模型名}-{时间戳}.{后缀名}` 命名,例如:
|
||||
- `gpt-image-2-2K-20260818_143025.png`
|
||||
- `grok-imagine-image-lite-20260818_143025.jpg`
|
||||
- 其中 `{调用的模型名}` 为实际调用的模型名(见上表),`{时间戳}` 使用 `%Y%m%d_%H%M%S` 格式(如 `20260818_143025`),`{后缀名}` 按实际图片类型(`.png` / `.jpg` / `.webp`)。
|
||||
- 脚本默认已按上述规范输出(`output/{模型名}-{时间戳}.{后缀名}`);如需自定义,通过 `-o` 指定,但仍应保持 `output/` 目录与「模型名-时间戳」命名格式。
|
||||
|
||||
## 使用方式
|
||||
|
||||
```bash
|
||||
# 使用默认提示词(脚本内 PROMPT 变量)生成图片
|
||||
python3 gpt-image-t2i/generate_image.py
|
||||
python3 grok-image-t2i/generate_image.py
|
||||
|
||||
# 传入自定义提示词(不传则使用脚本内硬编码的 PROMPT)
|
||||
python3 grok-image-t2i/generate_image.py "a cute cat sitting on a windowsill, soft morning light"
|
||||
|
||||
# 指定输出路径(必须输出到 output/ 文件夹,并按「模型名-时间戳」命名)
|
||||
python3 grok-image-t2i/generate_image.py -o output/grok-imagine-image-lite-20260818_143025.jpg
|
||||
|
||||
# 指定图片尺寸(GPT 支持 1024x1024 / 1536x1024 等)
|
||||
python3 gpt-image-t2i/generate_image.py --size 1536x1024
|
||||
```
|
||||
|
||||
## 命令行参数
|
||||
|
||||
- `prompt`:图片提示词(可选位置参数),不传则使用脚本内硬编码的 `PROMPT`
|
||||
- `--size`:图片尺寸,默认 `1024x1024`
|
||||
- `--output, -o`:输出文件路径,应指向 `output/` 下的文件,并按 `{模型名}-{时间戳}.{后缀名}` 命名(如 `-o output/gpt-image-2-2K-20260818_143025.png`)
|
||||
|
||||
## 自定义提示词
|
||||
|
||||
优先通过命令行参数传入(如 `python3 grok-image-t2i/generate_image.py "你的描述"`);如需修改默认提示词,编辑脚本中的 `PROMPT` 变量即可。建议使用详细、具体的英文描述以获得更好的效果。
|
||||
|
||||
## 注意事项
|
||||
|
||||
- 脚本依赖 Python 标准库(`urllib`、`base64` 等),无需安装第三方包。
|
||||
- 请求图片下载时需要携带浏览器 `User-Agent`,否则接口返回 403(脚本已处理)。
|
||||
- 生成图片通常需要几十秒,脚本设置了 120 秒超时。
|
||||
Reference in New Issue
Block a user