APIYI GPT-Image 2 画像生成スキル

概要

apiyi-gpt-image-2-gen と apiyi-gpt-image-2-all-gen は、コミュニティユーザー wuchubuzai2018 が提供した 2 つのオープンソース AI Agent スキルです。これらを使うと、APIYI の 2 つの OpenAI GPT 画像モデルである、公式 gpt-image-2（きめ細かな制御、token ベース課金、4K）とリバース gpt-image-2-all（会話型、呼び出しごとの課金、ChatGPT との同等性）を、Codex CLI, OpenCode, Gemini CLI, GitHub Copilot, Cursor, Amp をはじめとする任意の Skills 対応ツールから、1 つの自然言語 prompt だけで直接呼び出せます。

プロジェクト情報

🔗 ソース: github.com/wuchubuzai2018/expert-skills-hub
📦 スキルID: apiyi-gpt-image-2-gen（公式）、apiyi-gpt-image-2-all-gen（リバース）
👤 作者: wuchubuzai2018
⭐ コミュニティによる貢献で、作者の Nano Banana Pro Image-Gen Skill と同じリポジトリを共有しています

どのスキルを選べばよいですか？

apiyi-gpt-image-2-gen（公式、推奨）: 制御しやすい size / quality / output-format / compression、4K（3840×2160）、カスタムサイズ、セマンティック編集をサポートします。token ベース課金で、品質やサイズに明確な要件がある場合に最適です
apiyi-gpt-image-2-all-gen（リバース）: 必要なのは prompt と、任意の response-format だけです。サイズ/比率は prompt 内で指定します。呼び出しごとの課金（$0.03/call）で、ChatGPT の Web 体験と同等です。自然言語でそのまま出力したい場合、強いテキスト描画、反復編集に最適です
並べて比較: 公式 vs リバースの比較

主な機能

一文での画像生成

AI コーディングアシスタント内で中国語または英語でそのまま記述すると、画像が返ってきます

デュアルモデル対応

公式 gpt-image-2 とリバース gpt-image-2-all の両方が利用可能です — シナリオに応じて選べます

4K + カスタムサイズ（公式）

公式 Skill は 1024²、1536×1024、2048²、3840×2160 のプリセットとカスタム寸法に対応しています

品質 / 形式制御（公式）

quality（low / medium / high / auto）+ 出力形式（png / jpeg / webp）+ 圧縮 0-100

参照画像は最大5枚

両方の Skill は、マルチ画像融合とスタイル転送のために、最大5枚の重ねた参照画像に対応しています

マルチツール対応

Codex CLI、OpenCode、Gemini CLI、GitHub Copilot、Cursor、Amp で動作します

Node.js + Python ランタイム

generate_image.js と generate_image.py の両方を同梱しています

手間いらずのセットアップ

APIYI_API_KEY を一度設定すれば、-k で一時的に上書きできます

対応APIYIモデル

モデル	モデルID	機能	課金	APIドキュメント
GPT-Image 2（公式、推奨）	`gpt-image-2`	`apiyi-gpt-image-2-gen`	tokenごとの従量課金	表示
GPT-Image 2 All（リバース）	`gpt-image-2-all`	`apiyi-gpt-image-2-all-gen`	$0.03/回	表示

クイックスタート: 3ステップ

ステップ1: APIYIキーを取得する

APIYIコンソールにアクセスしてサインインする
トークンの下で、新しいキーを生成します（sk-で始まります）
推奨: 使用上限付きの専用キーを作成します

新規ユーザーには無料トライアル残高が付与されます — 2つのGPT画像モデルを試すのに十分です。

ステップ2: スキルをインストールする — どちらか一方を選ぶか、両方をインストールします

公式 gpt-image-2（推奨）:

npx skills add https://github.com/wuchubuzai2018/expert-skills-hub --skill apiyi-gpt-image-2-gen

リバース gpt-image-2-all:

npx skills add https://github.com/wuchubuzai2018/expert-skills-hub --skill apiyi-gpt-image-2-all-gen

Node.js が必要です。Python スクリプトはバックアップ実行環境として使えます。Node.js がインストールされていない場合は、nodejs.org から入手してください。

ステップ3: APIキーを設定する

環境変数を設定します（~/.zshrc / ~/.bashrc に永続化することを推奨します）:

export APIYI_API_KEY="sk-your-apiyi-key"

Windows PowerShell:

$env:APIYI_API_KEY="sk-your-apiyi-key"

完了です！Skills対応のAIコーディングツールなら、自然言語でこの2つのスキルを起動できるようになりました。

コマンドラインパラメータ

`apiyi-gpt-image-2-gen`（公式）

Parameter	Short	Required	Description	Example
`--prompt`	`-p`	Yes	生成 prompt または編集指示	`"An orange cat on grass"`
`--filename`	`-f`	No	出力パス（省略時は自動でタイムスタンプ付き）	`"cat.png"`
`--size`	`-s`	No	プリセット（`1024x1024` / `1536x1024` / `1024x1536` / `2048x2048` / `2048x1152` / `3840x2160` / `2160x3840`）またはカスタム	`"2048x1152"`
`--quality`	`-q`	No	`low` / `medium` / `high` / `auto`	`"high"`
`--output-format`	`-o`	No	`png`（デフォルト）/ `jpeg` / `webp`	`"webp"`
`--output-compression`	`-c`	No	0-100（jpeg / webp のみ）	`80`
`--input-image`	`-i`	No	参照画像、最大 5 枚	`"portrait.png"`
`--api-key`	`-k`	No	1 回分の環境変数を上書き	`"sk-xxx"`

対応アスペクト比: 1:1, 3:2, 2:3, 16:9, 9:16, および 3:1 以内の任意のカスタム比率。 カスタムサイズの制約: 各辺は 3840px 以下、両方の寸法は 16 で割り切れること、総ピクセル数は 655,360 から 8,294,400 の間であること。 通常のレイテンシ: 1 リクエストあたり 120〜150 秒（複雑な 4K シーンではさらに長くなります）。

`apiyi-gpt-image-2-all-gen`（逆）

Parameter	Short	Required	Description	Example
`--prompt`	`-p`	Yes	会話形式の prompt（サイズ/比率は prompt 内で記述）	`"widescreen 16:9 cyberpunk city"`
`--filename`	`-f`	No	出力パス（省略時は自動でタイムスタンプ付き PNG）	`"city.png"`
`--response-format`	`-r`	No	`url`（デフォルト、R2 CDN で約 24 時間有効）または `b64_json`	`"b64_json"`
`--input-image`	`-i`	No	参照画像、最大 5 枚	`"ref.png"`
`--api-key`	`-k`	No	1 回分の環境変数を上書き	`"sk-xxx"`

reverse スキルは size / quality / aspect_ratio の CLI フラグを受け付けません。それらはすべて prompt に記述してください（例: "vertical 9:16 mobile poster", "1024x1024 square"）。レイテンシ: 60〜300 秒。

使用例

例1: 公式の text-to-image を精密に制御

node scripts/generate_image.js \
  -p "Cinematic product shot of a minimalist ceramic teacup, soft morning light, 35mm lens" \
  -f "teacup.png" \
  -s "3840x2160" \
  -q "high" \
  -o "png"

例2: 公式の画像編集（参照画像）

node scripts/generate_image.js \
  -p "replace the background with a sunset beach, keep the subject intact" \
  -i "portrait.png" \
  -f "portrait-beach.jpg" \
  -s "2048x1152" \
  -q "high" \
  -o "jpeg" \
  -c 85

例3: 公式の複数画像融合

node scripts/generate_image.js \
  -p "put the person from img 1 into the scene from img 2, lighting style from img 3" \
  -i person.png scene.png light.png \
  -f merged.png \
  -q high

例4: 逆会話式（サイズは prompt で指定）

node scripts/generate_image.js \
  -p "widescreen 16:9 cinematic frame: a girl in hanfu under cherry blossoms, watercolor style, soft light" \
  -f "sakura.png" \
  -r url

例5: AIコーディングツールから呼び出す

インストール後は、Cursor / Codex CLI などでアシスタントにそのまま依頼するだけです。

「apiyi-gpt-image-2-gen を使って 3840x2160 の高品質なサイバーパンク都市の壁紙を生成して」
「apiyi-gpt-image-2-all-gen を呼び出して photo.jpg をスタジオジブリ風に変換して」
「公式スキルを使って 1:1 のロゴを高品質、webp 形式で作成して」

アシスタントが適切なスキルを選び、CLI のフラグを組み立ててくれます。

FAQ

どのスキルを選べばよいですか？

正確なサイズ（例: 3840×2160）、品質段階（low/medium/high）、または特定の出力フォーマット（webp / compression）が必要な場合 → 公式 apiyi-gpt-image-2-gen を選んでください
ChatGPT と同等の会話フロー、1回ごとの一律料金（$0.03）、強力なテキスト描画を重視し、サイズを自然言語で表現しても問題ない場合 → リバース apiyi-gpt-image-2-all-gen を選んでください
完全な比較: 公式版とリバース版の比較

`npx skills` のインストールに失敗する

Node.js がインストールされていることを確認してください（node -v）
GitHub へのネットワークアクセスを確認してください
npx skills が利用できない場合は、手動でクローンしてください:

git clone https://github.com/wuchubuzai2018/expert-skills-hub.git

その後、skills/apiyi-gpt-image-2-gen または skills/apiyi-gpt-image-2-all-gen のどちらかをローカルの Skills ディレクトリにコピーしてください。

API key が無効というエラー

APIYI_API_KEY が正しく設定されていることを確認してください（sk- で始まります）
残高 — 残高は十分に見えるのに呼び出しに失敗するを参照してください
簡単なテストとして、-k "sk-xxx" をインラインで渡してください

公式スキルがカスタムサイズを拒否する

カスタム size は次を満たす必要があります:

各辺は 3840px 以下
両方の寸法が 16 で割り切れること
総ピクセル数が 655,360 から 8,294,400 の間であることたとえば、2048x3072 は有効です。3000x2000 は 3000 が 16 で割り切れないため拒否されます。

リバーススキルの URL はどれくらい有効ですか？

リバーススキルのデフォルトの R2 CDN URL は、おおよそ 24時間 有効です。本番では、Base64 を受け取ってローカルに保存するために -r b64_json を渡すか、すぐにアセットをダウンロードしてください。

どの AI コーディングツールがサポートされていますか？

確認済み: Codex CLI、OpenCode、Gemini CLI、GitHub Copilot、Cursor、Amp。Skills に対応したツールであれば、どれでも動作するはずです。

gpt-image-2（公式）ドキュメント

ネイティブな2K/4K画像生成、tokenごとの課金

gpt-image-2-all（リバース）ドキュメント

ChatGPTとの同等性、$0.03/回

公式版 vs リバース版の比較

17項目の並列比較

Nano Banana Pro スキル（同じ作者）

同じリポジトリの姉妹スキル — Gemini 画像生成

Luck GPT-Image 2 ComfyUI Nodes

同じモデル、ComfyUIノード風

APIYI コンソール

キー、利用状況、チャネルを管理

概要

対話AI

プログラミング

コミュニティ投稿

AIエージェント

エンジニアリング

翻訳

APIYI GPT-Image 2 画像生成スキル

概要

主な機能

一文での画像生成

デュアルモデル対応

4K + カスタムサイズ（公式）

品質 / 形式制御（公式）

参照画像は最大5枚

マルチツール対応

Node.js + Python ランタイム

手間いらずのセットアップ

対応APIYIモデル

クイックスタート: 3ステップ

コマンドラインパラメータ

`apiyi-gpt-image-2-gen`（公式）

`apiyi-gpt-image-2-all-gen`（逆）

使用例

例1: 公式の text-to-image を精密に制御

例2: 公式の画像編集（参照画像）

例3: 公式の複数画像融合

例4: 逆会話式（サイズは prompt で指定）

例5: AIコーディングツールから呼び出す

FAQ

関連リソース

gpt-image-2（公式）ドキュメント

gpt-image-2-all（リバース）ドキュメント

公式版 vs リバース版の比較

Nano Banana Pro スキル（同じ作者）

Luck GPT-Image 2 ComfyUI Nodes

APIYI コンソール

​概要

​主な機能

一文での画像生成

デュアルモデル対応

4K + カスタムサイズ（公式）

品質 / 形式制御（公式）

参照画像は最大5枚

マルチツール対応

Node.js + Python ランタイム

手間いらずのセットアップ

​対応APIYIモデル

​クイックスタート: 3ステップ

​コマンドラインパラメータ

​apiyi-gpt-image-2-gen（公式）

​apiyi-gpt-image-2-all-gen（逆）

​使用例

​例1: 公式の text-to-image を精密に制御

​例2: 公式の画像編集（参照画像）

​例3: 公式の複数画像融合

​例4: 逆会話式（サイズは prompt で指定）

​例5: AIコーディングツールから呼び出す

​FAQ

​関連リソース

gpt-image-2（公式）ドキュメント

gpt-image-2-all（リバース）ドキュメント

公式版 vs リバース版の比較

Nano Banana Pro スキル（同じ作者）

Luck GPT-Image 2 ComfyUI Nodes

APIYI コンソール

概要

主な機能

対応APIYIモデル

クイックスタート: 3ステップ

コマンドラインパラメータ

`apiyi-gpt-image-2-gen`（公式）

`apiyi-gpt-image-2-all-gen`（逆）

使用例

例1: 公式の text-to-image を精密に制御

例2: 公式の画像編集（参照画像）

例3: 公式の複数画像融合

例4: 逆会話式（サイズは prompt で指定）

例5: AIコーディングツールから呼び出す

FAQ

関連リソース