transform-generate-image-with-transloadit

実行

プロンプトからすばやく画像を生成するには、Images 2.5 Flare で image generate インテントを使用します。 古い CLI が以前のデフォルトを選択しないように、モデルを明示的に指定してください。

npx -y @transloadit/node image generate \
  --model openai/gpt-image-2.5-flare \
  --prompt 'A minimal product photo of a chameleon on white background' \
  --output ./out.png

Images 2.5 Sunburst で実行

ユーザーから指定された場合、またはレイテンシより精度を優先する場合は、Sunburst を使用します。日常的な画像生成では Flare をデフォルトのまま使用してください。明示的に指定された古いモデルは、新しいモデルに黙って置き換えず、そのまま使用してください。

npx -y @transloadit/node image generate \
  --model openai/gpt-image-2.5-sunburst \
  --width 1024 \
  --height 1024 \
  --prompt 'A ceramic coffee mug on a white seamless studio background' \
  --output ./out.png

入力画像を使って実行

1 枚以上の入力画像を使って生成を誘導することもできます。意味のあるファイル名を付け、プロンプト内で参照してください。

npx -y @transloadit/node image generate \
  --model openai/gpt-image-2.5-flare \
  --input ./person1.jpg \
  --input ./person2.jpg \
  --input ./background.jpg \
  --prompt 'Place person1.jpg feeding person2.jpg in front of background.jpg' \
  --output ./out.png

メモ：

• デフォルトでは --model openai/gpt-image-2.5-flare を使用し、精度を重視する作業では --model openai/gpt-image-2.5-sunburst を使用してください。
• 明示的な --model openai/gpt-image-2 と Google Nano Banana の指定も引き続きサポートされます。古い gpt-image-2 という表記では、Images 2.5 ではなく GPT Image 2 が選択されます。
• 繰り返し指定した --input の値は、単一の /image/generate アセンブリにまとめられます。
• --input を指定しなくても、プロンプトのみで生成できます。
• --output を指定しない場合、プロンプトのみの実行と複数入力での実行では、デフォルトで現在の作業ディレクトリが使用されます。

失敗した場合のデバッグ

npx -y @transloadit/node assemblies get <assemblyIdOrUrl> -j

メモ：

• Images 2.5 には、対応する API2 バックエンドのロールアウトが必要です。モデルが利用できない場合やアカウントの制限がある場合は、その制限を伝え、代替案についてユーザーの確認を取ってください。明示的なモデルの選択を黙って変更したり、際限なく再試行したりしないでください。