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，或优先考虑精度而非延迟时，请使用 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

使用输入图像运行

你也可以使用一张或多张输入图像来引导生成。请使用有意义的文件名，并在提示词中引用这些文件。

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 写法仍会选择 GPT Image 2，而非 Images 2.5。
• 多个重复的 --input 值会打包到同一个 /image/generate 请求中。
• 不使用任何 --input 也可以仅根据提示词生成图像。
• 如果未指定 --output，仅提示词生成和多输入运行默认使用当前工作目录。

故障排查

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

注意：

• Images 2.5 需要匹配的 API2 后端完成发布。如果模型不可用或账号受限，请说明此限制并与用户确认替代方案；不要悄悄更改明确指定的模型，也不要无限重试。