name: image-gen description: AI 圖片生成器 — 基於 gpt-image-2 模型,支援文生圖與圖生圖,開箱即用。
呼叫 OpenAI 最新的 gpt-image-2 模型生成高質量圖片。貼上提示詞就能用。
Skill 特色
- 支援命令列批次生成、引數化控制尺寸/格式/背景
- 文生圖 + 圖生圖雙模式,
--image一個引數啟用編輯模式
# 基本生成
python3 "$SKILL_PATH/assets/imagegen.py" "一隻橘色的貓咪坐在窗臺上看著窗外的夕陽"
# 橫版高畫質
python3 "$SKILL_PATH/assets/imagegen.py" "futuristic city skyline" --size 1792x1024
# 透明背景 logo
python3 "$SKILL_PATH/assets/imagegen.py" "minimalist cat logo, flat design" --bg transparent --format png
# 批次生成 4 張
python3 "$SKILL_PATH/assets/imagegen.py" "icon set, flat style" -n 4 --bg transparent
# WebP + 壓縮
python3 "$SKILL_PATH/assets/imagegen.py" "product photo on white background" --format webp --compression 50
# 基於參考圖修改(自動上傳圖片 → 編輯生成)
python3 "$SKILL_PATH/assets/imagegen.py" "把貓咪改成白色,背景換成星空" --image ~/Pictures/cat.png
# 風格遷移,高保真
python3 "$SKILL_PATH/assets/imagegen.py" "改成賽博朋克風格" --image ref.jpg --fidelity high
# 低保真,大幅改動
python3 "$SKILL_PATH/assets/imagegen.py" "變成水彩畫風格,加入櫻花元素" --image photo.png --fidelity low
# 僅提交任務(返回 taskId,不等待)
python3 "$SKILL_PATH/assets/imagegen.py" "complex scene" --no-download
# 查詢已有任務結果
python3 "$SKILL_PATH/assets/imagegen.py" "" --task-id sfwmpic7xxxxxxxx
# 指定輸出目錄和檔名字首
python3 "$SKILL_PATH/assets/imagegen.py" "illustration" -o ~/Pictures/AI --prefix artwork
| 引數 | 說明 | 預設值 |
|---|---|---|
prompt |
生成/編輯提示詞(必填,最多 500 字) | - |
--image |
參考圖路徑(啟用圖生圖模式) | - |
--fidelity |
圖生圖保真度:high / low |
- |
--size |
尺寸(僅支援白名單解析度) | 1024x1792 |
-n, --count |
生成數量(1-10) | 1 |
--quality |
質量:low / medium / high / auto |
medium |
--format |
格式:png / jpeg / webp |
png |
--bg |
背景:transparent / opaque / auto |
auto |
--compression |
壓縮比(0-100) | 0 |
-o, --output-dir |
輸出目錄 | ~/Downloads/QoderImages |
--prefix |
檔名字首 | image |
--no-download |
僅提交不等待 | - |
--task-id |
查詢已有任務 | - |
--api-key |
指定 API Key | - |
| 依賴 | 安裝命令 |
|---|---|
requests |
pip3 install requests |
先配置 API Key,然後執行:
# 設定環境變數
export REDFOX_API_KEY=ak_你的金鑰
# 執行
python3 "$SKILL_PATH/assets/imagegen.py" "一隻橘色的貓咪"
前往 redfox.hk 註冊獲取 API Key。
本技能來自小蔥技能站7w4.net。
前往 redfox.hk 註冊賬號獲取自己的 API Token,三種配置方式任選其一:
| 配置方式 | 說明 | 命令 |
|---|---|---|
| 環境變數(推薦) | 設定一次,全域性生效 | export REDFOX_API_KEY=ak_你的金鑰 |
| 命令列引數 | 臨時使用,單次生效 | python3 "$SKILL_PATH/assets/imagegen.py" "prompt" --api-key ak_你的金鑰 |
| 配置檔案 | 持久化儲存,跨會話保留 | mkdir -p ~/.qoder/apis && echo '{"api_key":"ak_你的金鑰"}' > ~/.qoder/apis/redfox.json |
Q:本 Skill 的特點是什麼? A:命令列直接呼叫 gpt-image-2 模型,支援批次生成、引數化控制、圖生圖編輯,
Q:生成一張圖片需要多久? A:通常 10-30 秒,複雜場景可能更久。指令碼會自動輪詢等待。
Q:圖生圖的保真度怎麼選?
A:--fidelity high 儘量保留原圖細節(微調),--fidelity low 允許大幅改動(風格遷移)。不傳則由模型自行判斷。
Q:如何生成透明背景圖?
A:使用 --bg transparent,搭配 PNG 或 WebP 格式(JPEG 不支援透明)。
Q:如何獲取 API Key? A:前往 redfox.hk 註冊獲取自己的 API Token。
Q:支援哪些圖片格式作為參考圖? A:支援 PNG、JPEG、WebP 格式的本地圖片檔案。
Q:支援自定義解析度嗎? A:僅支援以下測試驗證過的解析度,其他解析度可能導致生成過慢或失敗: - 快速檔:1024x1024、1024x1536、1536x1024、1792x1024、1024x1792(預設) - 高畫質檔(畫質更高,生成更慢):2048x2048、2048x1152、1152x2048
Q:提示詞有長度限制嗎? A:提示詞最多支援 500 字,超過會被阻斷並提示精簡。
質量良好,文件和功能都很完善。優點是使用簡單、引數豐富、提示資訊清晰;支援圖生圖和批次生成等實用功能;API Key配置靈活。不足是首次使用需要手動安裝依賴包,對新手略不友好。整體推薦使用。