gpt-image-2

GPT-Image-2

Frevana の AI Factory 画像 API を通じて画像を生成または編集します。

このスキルは、検証済みの API レスポンス JSON を変更せずに返します。data[0].image_url を主要な画像 URL として扱ってください。

このスキルに必要なもの

• ユーザーが指定した prompt または contents
• 任意の参照画像入力：--image、--image-url、--image-dir、--mask
• 任意の Frevana 画像オプション：n、size、quality、background、output_format、output_compression
• 環境変数の FREVANA_TOKEN、または今回の実行に限り明示的に指定する --token オーバーライド
• 任意の FREVANA_AGENT_APP_INSTANCE_ID。空でない場合、画像生成リクエストのヘッダーとして x-frevana-agent-app-instance-id を送信します
• curl
• bash
• python3

実行順序

1. ユーザーが画像プロンプトを指定していることを確認します。
2. ユーザーがローカル画像ファイルを 1 つ以上参照している場合は、それぞれを --image で渡します。
3. ユーザーがリモート画像 URL を 1 つ以上参照している場合は、それぞれを --image-url で渡します。スクリプトが対応画像をダウンロードしてから、既存のアップロード処理を再利用します。
4. ユーザーが画像を含むローカルディレクトリを指定している場合は、--image-dir で渡します。スクリプトがそのディレクトリから対応画像を再帰的に収集します。
5. ユーザーがローカルのマスク画像を指定している場合は、--mask で渡し、PNG 形式のみを使用します。
6. 画像のルーティングオーバーライドを求めたり、渡したりしないでください。Frevana スクリプトが管理します。
7. その場しのぎの curl コマンドではなく、スクリプトを優先して使用します。
8. まずスクリプトに FREVANA_TOKEN を読み込ませます。
9. FREVANA_AGENT_APP_INSTANCE_ID が空でない場合、スクリプトに画像生成リクエストへの x-frevana-agent-app-instance-id の付与を任せます。
10. 非対話型の実行では、トークンがない場合は速やかに失敗させ、FREVANA_TOKEN を設定するか --token を渡すようユーザーに伝えます。
11. API レスポンス JSON をそのまま返すか、ユーザーがホストされたアセットのみを求めている場合は最初の画像 URL を返します。
12. 必要に応じて、--output で JSON を保存します。

使用可能なオプション

• --n：1-10
• --size：auto、1024x1024、1536x1024、1024x1536、256x256、512x512、1792x1024、1024x1792
• --quality：standard、hd、low、medium、high、auto
• --background：opaque、auto
• --output-format：png、jpeg、webp
• --output-compression：1-100
• --image：繰り返し指定可能なローカルファイルパス。.png／.jpg／.jpeg／.webp に対応し、各ファイルは 50MB 未満
• --image-url：繰り返し指定可能なリモート http:// または https:// の画像 URL。対応する .png／.jpg／.jpeg／.webp ファイルをダウンロードし、各ファイルは 50MB 未満
• --image-dir：繰り返し指定可能なローカルディレクトリパス。対応画像を再帰的に読み込み、--image、--image-url、--image-dir を合わせて最大 16 枚
• --mask：任意のローカル .png パス。4MB 未満で、画像入力がある場合のみ指定可能

コマンド

bash <skill-path>/scripts/generate_image.sh \
  --prompt "A cinematic product photo of a matte black espresso machine on travertine" \
  --size 1536x1024 \
  --quality high \
  --background opaque \
  --output-format png \
  --output ./out/gpt-image-2-result.json

bash <skill-path>/scripts/generate_image.sh \
  --prompt "Turn these product references into one polished hero shot" \
  --image ./refs/front.png \
  --image-url "https://example.com/reference/detail.png" \
  --image-dir ./refs/detail-shots \
  --mask ./refs/mask.png \
  --size 1024x1024 \
  --output ./out/gpt-image-2-edit-result.json

レスポンス形式

{
  "created": 1777367067,
  "background": "opaque",
  "output_format": "png",
  "quality": "high",
  "size": "1536x1024",
  "data": [
    {
      "revised_prompt": "string",
      "image_url": "https://static.frevana.com/images/user-id/example-image-id.png"
    }
  ],
  "credits_consumed": 1
}

注意事項

• 画像のルーティングオーバーライドを渡さないでください。ラッパーによって拒否されます。
• --background transparent を渡さないでください。gpt-image-2 は現在、透明な背景に対応していません。
• ユーザーが「/path/to/reference.png を使用して」と言った場合は、--image /path/to/reference.png に対応付けます。
• ユーザーが「https://example.com/reference.png を使用して」と言った場合は、--image-url https://example.com/reference.png に対応付けます。
• ユーザーが「/path/to/references 内の画像を使用して」と言った場合は、--image-dir /path/to/references に対応付けます。
• 画像から画像へのリクエストでも、prompt／contents は必須のままです。
• ユーザーから依頼がない限り、返された Frevana の画像 URL を書き換えたり、プロキシ経由にしたり、変換したりしないでください。