# ToAPIs 图像生成工作流

## 当前推荐链路（2026-04-06）

- Best URL：`https://toapis.com`
- 默认调试模型：`gpt-4o-image`
- 低成本 Gemini 调试：`gemini-3.1-flash-image-preview`
- 高质量最终出图：`gemini-3-pro-image-preview`

当前脚本在 `https://toapis.com` 下的行为：

1. `POST /v1/images/generations` 创建异步任务
2. `GET /v1/images/generations/{task_id}` 轮询状态
3. 如果有本地 `--input`，先 `POST /v1/uploads/images`
4. 完成后自动下载图片

---

## 1. 最低成本链路验证

适合：

- 先确认 key 是否可用
- 先确认网络、轮询、下载链路是否正常
- 不希望一开始就烧贵模型

命令：

```bash
python $HOME/.claude/skills/gemini-image-api/scripts/gemini_generate.py \
  "一只极简线稿风格的小猫头像，白底，单主体" \
  --model gpt-4o-image \
  --aspect-ratio 1:1 \
  --output out.png
```

---

## 2. 低成本 Gemini 调试链路

适合：

- 想继续用 Gemini 系图像模型
- 但又不想一开始就用 Pro

命令：

```bash
python $HOME/.claude/skills/gemini-image-api/scripts/gemini_generate.py \
  "赛博朋克风格的城市夜景，霓虹灯闪烁" \
  --model gemini-3.1-flash-image-preview \
  --aspect-ratio 16:9 \
  --image-size 2K \
  --output gemini-flash.png
```

---

## 3. 本地参考图重绘

适合：

- manuscript 图件改写
- graphical abstract 小步迭代
- roadmap / mechanism figure 局部优化

命令：

```bash
python $HOME/.claude/skills/gemini-image-api/scripts/gemini_generate.py \
  "把它改成赛博朋克风格，但保留主体构图和信息层级" \
  --model gpt-4o-image \
  --input reference.png \
  --output edited.png
```

说明：

- 当前脚本会先上传 `reference.png`
- 再把返回的 URL 塞到 `image_urls`
- 然后创建图片任务并轮询

---

## 4. 高质量最终出图

如果已经完成低成本调试，需要正式交付图件，再切高质量模型：

```bash
python $HOME/.claude/skills/gemini-image-api/scripts/gemini_generate.py \
  --prompt-file final_prompt.txt \
  --model gemini-3-pro-image-preview \
  --aspect-ratio 16:9 \
  --image-size 4K \
  --output final.png
```

---

## 5. 推荐操作顺序

1. 先用 `gpt-4o-image` 跑通链路
2. 再决定要不要切到 `gemini-3.1-flash-image-preview`
3. 最后只有在确实需要时才上 `gemini-3-pro-image-preview`
4. 复杂 prompt 一律优先 `--prompt-file`
5. 换机器、换 key、换 provider 时，先 `--dry-run` 或 `--print-config-source`
