致謝

本專案基於 原 GitHub 專案 開發，感謝作者 evolink.ai 提供的優秀開源成果！

image-gen-proxy

AI Agent? 可跳過 README，直接閱讀 llms-install.md 取得面向 Agent 的安裝步驟。

📑 選單

• 這是什麼？
• 安裝
• 設定
• 展示
• GPT Image API 代理生成
• 檔案結構
• 疑難排解
• 相容性
• 授權

這是什麼？

image-gen-proxy 是 AI Agent 圖像生成技能與 npm 安裝器，用於對接 OpenAI 相容的 GPT Image API 代理。它不使用固定 API 閘道，而是從專案 .env 或系統環境讀取 GPT_IMAGE_BASE_URL 與 GPT_IMAGE_API_KEY。

| 技能 | 描述 | 預設模型 | |---|---|---| | Image Gen Proxy | 文生圖、圖像編輯、批量生成、可配置 API 代理、本機下載 | gpt-image-2 |

安裝

npx image-gen-proxy
npx image-gen-proxy -y --path ~/.codex/skills
npx image-gen-proxy -y --path ~/.claude/skills

手動安裝：

cd image-gen-proxy
node ./bin/cli.js -y --path ~/.codex/skills

設定

在專案根目錄建立 .env，或設定系統環境變數。系統環境變數優先於 .env。

GPT_IMAGE_BASE_URL=https://your-image-api-proxy.example.com
GPT_IMAGE_API_KEY=your_key_here

| 變數 | 用途 | |---|---| | GPT_IMAGE_BASE_URL | 圖像 API 代理基礎位址，不要帶結尾斜線 | | GPT_IMAGE_API_KEY | 代理的 Bearer Token |

展示

| 人像風格 | 產品行銷 | 角色設計 | |---|---|---| | | | |

GPT Image API 代理生成

• --model=<model>：模型名稱，預設 gpt-image-2
• --out=<path>：輸出目錄，預設 ./gpt-image-files，不存在時會自動建立
• --image=<url-or-local-path[,url-or-local-path...]>：參考圖；URL 原樣傳入，本機檔案會轉為 base64
• --count=<1-10>：批量生成數量
• --dry-run：只預覽 JSON payload，不呼叫遠端 API

node ./scripts/gpt-image-gen.js "海面上的美麗日落"
node ./scripts/gpt-image-gen.js "未來城市天際線" --model=gpt-image-2 --out=D:/gpt-images/ --size=16:9 --resolution=4K --quality=high
node ./scripts/gpt-image-gen.js "測試提示詞" --dry-run

輸出協議

TASK_SUBMITTED: task_id=<id> estimated=<Ns>
IMAGE_URL=<remote-url>
IMAGE_FILE=<local-path>
ELAPSED=<Ns>
ERROR: <message>

檔案結構

.
├── README.md / README.*.md
├── SKILL.md
├── bin/cli.js
├── references/api-params.md
└── scripts/gpt-image-gen.js

疑難排解

| 問題 | 解法 | |---|---| | GPT_IMAGE_BASE_URL is required | 在 .env 或系統環境中設定。 | | GPT_IMAGE_API_KEY is required | 設定有效代理 Token。 | | 沒有本機圖片檔案 | 檢查 IMAGE_URL 下載回應和 --out 權限。 | | 模型不對 | 明確傳入 --model=<model>。 |

相容性

Codex、Claude Code、OpenCode、OpenClaw、Cursor 或任何支援 skills 目錄的 Agent 均可使用 npx image-gen-proxy -y --path <skills-dir> 安裝。

授權

MIT