Skip to content

Use canonical OpenAI image model spelling #397

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
kvz merged 1 commit into from
Apr 23, 2026
Merged

Use canonical OpenAI image model spelling #397

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions packages/node/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -236,7 +236,7 @@ npx transloadit image generate [--input <path|dir|url|->] [options]
| Flag | Type | Required | Example | Description |
| --- | --- | --- | --- | --- |
| `--prompt` | `string` | yes | `"A red bicycle in a studio"` | The prompt describing the desired image content. |
| `--model` | `string` | no | `google/nano-banana-2` | The AI model to use for image generation. Defaults to google/nano-banana-2. Backend-supported models include gpt-image-2 and Google Nano Banana variants. |
| `--model` | `string` | no | `google/nano-banana-2` | The AI model to use for image generation. Defaults to google/nano-banana-2. Backend-supported models include openai/gpt-image-2 and Google Nano Banana variants. |
| `--format` | `string` | no | `jpg` | Format of the generated image. |
| `--seed` | `number` | no | — | Seed for the random number generator. |
| `--aspect-ratio` | `string` | no | — | Aspect ratio of the generated image. |
Expand All @@ -251,7 +251,7 @@ npx transloadit image generate [--input <path|dir|url|->] [options]
# Generate an image from text
transloadit image generate --prompt "A red bicycle in a studio" --output output.png
# Generate with OpenAI gpt-image-2
transloadit image generate --model gpt-image-2 --width 1024 --height 1024 --prompt "A ceramic coffee mug on a white sweep" --output output.png
transloadit image generate --model openai/gpt-image-2 --width 1024 --height 1024 --prompt "A ceramic coffee mug on a white sweep" --output output.png
# Guide generation with one input image
transloadit image generate --input subject.jpg --prompt "Place subject.jpg on a magazine cover" --output output.png
# Guide generation with multiple input images
Expand Down Expand Up @@ -1863,3 +1863,4 @@ See [CONTRIBUTING](./CONTRIBUTING.md).




4 changes: 2 additions & 2 deletions packages/node/docs/intent-commands.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -104,7 +104,7 @@ npx transloadit image generate [--input <path|dir|url|->] [options]
| Flag | Type | Required | Example | Description |
| --- | --- | --- | --- | --- |
| `--prompt` | `string` | yes | `"A red bicycle in a studio"` | The prompt describing the desired image content. |
| `--model` | `string` | no | `google/nano-banana-2` | The AI model to use for image generation. Defaults to google/nano-banana-2. Backend-supported models include gpt-image-2 and Google Nano Banana variants. |
| `--model` | `string` | no | `google/nano-banana-2` | The AI model to use for image generation. Defaults to google/nano-banana-2. Backend-supported models include openai/gpt-image-2 and Google Nano Banana variants. |
| `--format` | `string` | no | `jpg` | Format of the generated image. |
| `--seed` | `number` | no | — | Seed for the random number generator. |
| `--aspect-ratio` | `string` | no | — | Aspect ratio of the generated image. |
Expand All @@ -119,7 +119,7 @@ npx transloadit image generate [--input <path|dir|url|->] [options]
# Generate an image from text
transloadit image generate --prompt "A red bicycle in a studio" --output output.png
# Generate with OpenAI gpt-image-2
transloadit image generate --model gpt-image-2 --width 1024 --height 1024 --prompt "A ceramic coffee mug on a white sweep" --output output.png
transloadit image generate --model openai/gpt-image-2 --width 1024 --height 1024 --prompt "A ceramic coffee mug on a white sweep" --output output.png
# Guide generation with one input image
transloadit image generate --input subject.jpg --prompt "Place subject.jpg on a magazine cover" --output output.png
# Guide generation with multiple input images
Expand Down
12 changes: 8 additions & 4 deletions packages/node/src/alphalib/types/robots/image-generate.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -85,7 +85,7 @@ Best practice:
.string()
.optional()
.describe(
'The AI model to use. Defaults to google/nano-banana. Supported models include flux-1.1-pro-ultra, flux-schnell, recraft-v3, google/nano-banana, google/nano-banana-2, google/nano-banana-pro, gpt-image-2, and stability-ai/stable-diffusion-inpainting.',
'The AI model to use. Defaults to google/nano-banana. Supported models include flux-1.1-pro-ultra, flux-schnell, recraft-v3, google/nano-banana, google/nano-banana-2, google/nano-banana-pro, openai/gpt-image-2, and stability-ai/stable-diffusion-inpainting. The legacy alias gpt-image-2 is also accepted for backwards compatibility.',
),
prompt: z
.string()
Expand All @@ -96,7 +96,7 @@ Best practice:
.enum(['jpeg', 'jpg', 'png', 'gif', 'webp', 'svg'])
.optional()
.describe(
'Output format. Defaults depend on model: png for Google models and gpt-image-2, svg for recraft-v3, jpeg for others. Google models currently return PNG only.',
'Output format. Defaults depend on model: png for Google models and openai/gpt-image-2, svg for recraft-v3, jpeg for others. Google models currently return PNG only.',
),
seed: z.number().optional().describe('Seed for the random number generator.'),
aspect_ratio: z
Expand All @@ -108,11 +108,15 @@ Best practice:
height: z
.number()
.optional()
.describe('Requested output height in pixels (mainly used by Google image models and gpt-image-2).'),
.describe(
'Requested output height in pixels (mainly used by Google image models and openai/gpt-image-2).',
),
width: z
.number()
.optional()
.describe('Requested output width in pixels (mainly used by Google image models and gpt-image-2).'),
.describe(
'Requested output width in pixels (mainly used by Google image models and openai/gpt-image-2).',
),
style: z.string().optional().describe('Style of the generated image.'),
num_outputs: z
.number()
Expand Down
4 changes: 2 additions & 2 deletions packages/node/src/cli/semanticIntents/imageGenerate.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ const imageGenerateOptionDefinitions = [
kind: 'string',
propertyName: 'model',
optionFlags: '--model',
description: `The AI model to use for image generation. Defaults to ${defaultImageGenerateModel}. Backend-supported models include gpt-image-2 and Google Nano Banana variants.`,
description: `The AI model to use for image generation. Defaults to ${defaultImageGenerateModel}. Backend-supported models include openai/gpt-image-2 and Google Nano Banana variants.`,
required: false,
exampleValue: defaultImageGenerateModel,
},
Expand Down Expand Up @@ -95,7 +95,7 @@ const imageGenerateCommandPresentation = {
],
[
'Generate with OpenAI gpt-image-2',
'transloadit image generate --model gpt-image-2 --width 1024 --height 1024 --prompt "A ceramic coffee mug on a white sweep" --output output.png',
'transloadit image generate --model openai/gpt-image-2 --width 1024 --height 1024 --prompt "A ceramic coffee mug on a white sweep" --output output.png',
],
[
'Guide generation with one input image',
Expand Down
6 changes: 3 additions & 3 deletions packages/node/test/unit/cli/intents.test.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -524,14 +524,14 @@ describe('intent commands', () => {
)
})

it('passes through gpt-image-2 and explicit dimensions for image generate', async () => {
it('passes through openai/gpt-image-2 and explicit dimensions for image generate', async () => {
const { createSpy } = await runIntentCommand([
'image',
'generate',
'--prompt',
'A ceramic coffee mug on a white sweep',
'--model',
'gpt-image-2',
'openai/gpt-image-2',
'--width',
'1024',
'--height',
Expand All @@ -550,7 +550,7 @@ describe('intent commands', () => {
stepsData: {
generate: expect.objectContaining({
robot: '/image/generate',
model: 'gpt-image-2',
model: 'openai/gpt-image-2',
prompt: 'A ceramic coffee mug on a white sweep',
width: 1024,
height: 1024,
Expand Down
5 changes: 3 additions & 2 deletions packages/transloadit/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -236,7 +236,7 @@ npx transloadit image generate [--input <path|dir|url|->] [options]
| Flag | Type | Required | Example | Description |
| --- | --- | --- | --- | --- |
| `--prompt` | `string` | yes | `"A red bicycle in a studio"` | The prompt describing the desired image content. |
| `--model` | `string` | no | `google/nano-banana-2` | The AI model to use for image generation. Defaults to google/nano-banana-2. Backend-supported models include gpt-image-2 and Google Nano Banana variants. |
| `--model` | `string` | no | `google/nano-banana-2` | The AI model to use for image generation. Defaults to google/nano-banana-2. Backend-supported models include openai/gpt-image-2 and Google Nano Banana variants. |
| `--format` | `string` | no | `jpg` | Format of the generated image. |
| `--seed` | `number` | no | — | Seed for the random number generator. |
| `--aspect-ratio` | `string` | no | — | Aspect ratio of the generated image. |
Expand All @@ -251,7 +251,7 @@ npx transloadit image generate [--input <path|dir|url|->] [options]
# Generate an image from text
transloadit image generate --prompt "A red bicycle in a studio" --output output.png
# Generate with OpenAI gpt-image-2
transloadit image generate --model gpt-image-2 --width 1024 --height 1024 --prompt "A ceramic coffee mug on a white sweep" --output output.png
transloadit image generate --model openai/gpt-image-2 --width 1024 --height 1024 --prompt "A ceramic coffee mug on a white sweep" --output output.png
# Guide generation with one input image
transloadit image generate --input subject.jpg --prompt "Place subject.jpg on a magazine cover" --output output.png
# Guide generation with multiple input images
Expand Down Expand Up @@ -1863,3 +1863,4 @@ See [CONTRIBUTING](./CONTRIBUTING.md).