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

概要

apiyi-gpt-image-2-gen と apiyi-gpt-image-2-all-gen は、コミュニティユーザーの wuchubuzai2018 氏によって提供された2つのオープンソース AI Agent Skill です。Codex CLI、OpenCode、Gemini CLI、GitHub Copilot、Cursor、Amp、および任意の Skills 互換ツールから直接、単一の自然言語 prompt で APIYI の2つの OpenAI GPT 画像モデル（公式 gpt-image-2（きめ細かな制御、token ベースの課金、4K）および リバース gpt-image-2-all（対話型、呼び出しごとの課金、ChatGPT と同等））を呼び出すことができます。

プロジェクト情報

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

どちらの 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.025/呼び出し）。ChatGPT Web 体験と同等 — 自然言語による直接出力、強力なテキスト描画、反復的な編集に最適です
完全な比較: 公式版とリバース版の比較

主な機能

一文での画像生成

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`	1回あたり $0.025	表示

クイックスタート: 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 のフラグを組み立ててくれます。

よくある質問

どちらのスキルを選ぶべきですか？

正確なサイズ（例: 3840×2160）、品質ティア（低/中/高）、または特定の出力フォーマット（webp / 圧縮）が必要な場合 → 公式 apiyi-gpt-image-2-gen を選択してください
ChatGPTと同等の対話フロー、呼び出しごとの定額料金（$0.025）、強力なテキスト描画を重視し、サイズを自然言語で指定しても問題ない場合 → リバース 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 キーの無効エラー

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

公式スキルでカスタムサイズが拒否されます

カスタム size は以下の条件を満たす必要があります:

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

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

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

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

動作確認済み: Codex CLI、OpenCode、Gemini CLI、GitHub Copilot、Cursor、Amp。Skills と互換性のあるツールであれば動作するはずです。

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

ネイティブ2K/4K生成、token単位の課金

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

ChatGPTと同等、1回あたり$0.025

公式 vs リバースの比較

17項目による横並び比較

Nano Banana Pro Skill（同一作者）

同じリポジトリの姉妹Skill — Gemini画像生成

Luck GPT-Image 2 ComfyUI ノード

同一モデルの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コーディングツールから呼び出す

よくある質問

関連リソース

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

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

公式 vs リバースの比較

Nano Banana Pro Skill（同一作者）

Luck GPT-Image 2 ComfyUI ノード

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コーディングツールから呼び出す

​よくある質問

​関連リソース

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

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

公式 vs リバースの比較

Nano Banana Pro Skill（同一作者）

Luck GPT-Image 2 ComfyUI ノード

APIYI コンソール

概要

主な機能

APIYI 対応モデル

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

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

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

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

使用例

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

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

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

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

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

よくある質問

関連リソース