# Transform Generate Image With Transloadit

> 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.

- Skill: `transloadit/transform-generate-image-with-transloadit` (Agent Skill)
- Install (CLI): `npx skillmds add transloadit/transform-generate-image-with-transloadit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/transloadit/transform-generate-image-with-transloadit/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: transloadit (https://skillmd.com/u/transloadit)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/transloadit/transform-generate-image-with-transloadit

---


# Run

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

```bash
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`.

```bash
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.

```bash
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

```bash
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.