transform-generate-image-with-transloadit

name	transform-generate-image-with-transloadit
description	One-off image generation (prompt -> image file) using Transloadit via the `transloadit` CLI. Prefer `image generate` for text-only and input-guided generation, and use `--output` when you need a deterministic path.
when_to_use	Triggers when the user asks to generate an image, create an image from a prompt, make an AI image, render a picture from text, or guide image generation with reference photos. Choose this for prompt-driven or prompt+input-guided generation of a local image file. Prefer this over the collage skills when the input is a text prompt rather than N existing photos to composite.

Run

Use the image generate intent for quick image generation from a prompt.

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

Run With OpenAI gpt-image-2

Use this when the user explicitly asks for openai/gpt-image-2, gpt-image-2, or OpenAI image generation. Keep it opt-in for now; the CLI default remains google/nano-banana-2.

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

Run With Input Images

You can also guide generation with one or more input images. Prefer meaningful filenames and refer to them in the prompt.

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

Notes:

• The CLI defaults to google/nano-banana-2.
• Use --model openai/gpt-image-2 for OpenAI image generation. The older gpt-image-2 spelling is still accepted by API2 for backwards compatibility.
• Repeated --input values are bundled into a single /image/generate assembly.
• Prompt-only generation still works without any --input.
• Without --output, prompt-only and multi-input runs default to the current working directory.

Debug If It Fails

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

Notes:

• Some generator/AI robots can be account-gated; if the assembly fails with capability or availability errors, switch models or confirm the feature is enabled for your account.