mcpField
A
apimart-image-gen

apimart-image-gen

github.com/kangarookingクリエイティブ・メディア68847 回インストール7 週間前に更新
リポジトリ

apimart-image-gen について

APIMart Image Genは、APIMart経由でGPT-Image-2を使う画像生成スキルです。非同期ジョブの送信、状態確認、結果のダウンロードに対応し、テキスト指示とURLまたはローカルファイルの参照画像を利用できます。

主な機能

  1. 01GPT-Image-2の画像ジョブを送信
  2. 02テキスト指示から画像を生成
  3. 03URLとローカルファイルを参照画像に指定
  4. 04タスク状態を確認して結果を取得
  5. 05dry-runでリクエスト形式を検証

活用シーン

  1. 01テキストの説明から画像を作成
  2. 02参照画像を変換または合成
  3. 03既存タスクを確認して出力をダウンロード
  4. 04送信前に画像生成パラメーターを検証

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/kangarooking/kangarooking-skills --skill apimart-image-gen

インストール後、Claude Code で/apimart-image-genを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
api.md
scripts/
apimart_image_gen.py

詳細

APIMart 画像生成

このスキルを使用すると、GPT-Image-2 の画像生成ジョブを APIMart に送信し、非同期タスクの結果をポーリングして、返された画像 URL をダウンロードできます。

認証情報のルール

API キーは環境変数から読み取ってください。プロンプト、スクリプト、スキルファイル、zip パッケージ、コミット、シェル履歴に API キーをハードコードしないでください。

推奨変数：

export APIMART_API_KEY="..."

ヘルパーは、フォールバックとして APIMART_TOKEN も受け付けます。

クイックスタート

通常のリクエストには、同梱のヘルパーを使用してください。

python scripts/apimart_image_gen.py generate \
  --prompt "一只橘猫坐在窗台上看夕阳，水彩画风格" \
  --size "16:9" \
  --resolution "2k" \
  --output-dir ./outputs/apimart-image-gen

スクリプトは POST /v1/images/generations を送信し、最初のポーリング前に待機してから、GET /v1/tasks/{task_id} を照会し、完了した画像 URL を --output-dir にダウンロードします。

ワークフロー

テキストから画像を生成：

python scripts/apimart_image_gen.py generate \
  --prompt "a corgi astronaut on the moon, cinematic" \
  --size "16:9" \
  --resolution "2k"

公開 URL を使った画像から画像への生成：

python scripts/apimart_image_gen.py generate \
  --prompt "把参考图变成水彩画风格" \
  --image-url "https://example.com/photo.jpg" \
  --size "4:3" \
  --resolution "2k"

ローカルファイルを使った画像から画像への生成：

python scripts/apimart_image_gen.py generate \
  --prompt "融合这些参考图，生成一张公众号封面" \
  --image-file ./reference-a.png \
  --image-file ./reference-b.jpg \
  --size "21:9" \
  --resolution "2k"

既存のタスクを確認：

python scripts/apimart_image_gen.py status \
  --task-id task_01KPQ7J7DWB7QZ3WCEK3YVPBRA \
  --download \
  --output-dir ./outputs/apimart-image-gen

API を呼び出さずにリクエストの形式を検証：

python scripts/apimart_image_gen.py generate \
  --prompt "星空下的古老城堡" \
  --size "16:9" \
  --resolution "4k" \
  --dry-run

デフォルト値と制限

  • モデルは gpt-image-2 に固定されています。
  • n は整数の 1 に固定されています。文字列の "1" は送信しないでください。
  • 有効な resolution の値は 1k、2k、4k です。
  • 有効なアスペクト比の値は auto、1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、2:1、1:2、3:1、1:3、21:9、9:21 です。
  • 1881x836 や 887x1774 などのピクセルサイズも受け付けます。
  • --image-url と --image-file を合わせて、最大 16 枚の参照画像を指定できます。
  • 指示が競合しないよう、アスペクト比はプロンプトではなく --size に指定することを推奨します。
  • APIMart から expires_at のタイムスタンプが通知されるため、結果の URL は速やかにダウンロードしてください。

リファレンス

エンドポイントの詳細、ステータス値、エラー処理、サイズと解像度の対応表が必要な場合は、references/api.md を読んでください。

コメント

Markdown 対応