toor
3b2fdc4402
- gpt-image-t2i / grok-image-t2i：OpenAI 兼容接口文生图脚本 - SKILLS.md：输出规范（统一输出到 output/，按「模型名-时间戳」命名） - 接口与参数说明文档
55 lines
3.0 KiB
Markdown
55 lines
3.0 KiB
Markdown
# 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 秒超时。
|