n8n-nodes-gpt-image-1-5

This is an n8n community node for GPT Image 1.5, an AI-powered image generation model. It allows you to generate images from text prompts, create variations of existing images, edit images with masks, and check generation status within your n8n workflows.

Installation

Follow the installation guide in the n8n community nodes documentation.

npm install n8n-nodes-gpt-image-1-5

Credentials

You need a GPT Image 1.5 API key to use this node. Configure the credentials with:

• API Key: Your GPT Image 1.5 API key
• Base URL: (Optional) Custom API endpoint URL

Operations

Generate Image

Generate images from text descriptions with advanced options:

• Prompt: Text description of the desired image
• Size: Image dimensions (256x256, 512x512, 1024x1024, 1792x1024, 1024x1792)
• Quality: Standard or HD quality
• Style: Vivid or Natural style
• Number of Images: Generate multiple images (1-10)

Additional Options:

• Negative prompt (what NOT to include)
• Seed for reproducible results
• Inference steps (1-100)
• Guidance scale (1-20)
• Response format (URL or Base64 JSON)

Generate Variations

Create variations of an existing image:

• Image URL: URL of the source image
• Size: Output image dimensions
• Number of Images: How many variations to create

Edit Image

Modify existing images using text prompts and optional masks:

• Original Image URL: Source image to edit
• Prompt: Description of desired changes
• Mask URL: (Optional) Mask to specify edit regions

Get Generation Status

Check the status of long-running image generation tasks:

• Task ID: ID of the generation task to check

Example Usage

Basic Image Generation

1. Add the GPT Image 1.5 node to your workflow
2. Select "Generate Image" operation
3. Enter your prompt: "A serene mountain landscape at sunset"
4. Configure size and quality settings
5. Execute the workflow

Advanced Generation with Custom Settings

{
  "prompt": "A futuristic city skyline with flying cars",
  "size": "1792x1024",
  "quality": "hd",
  "style": "vivid",
  "numberOfImages": 3,
  "additionalFields": {
    "negativePrompt": "blurry, low quality, distorted",
    "seed": 42,
    "steps": 50,
    "guidanceScale": 10
  }
}

Image Variations Workflow

1. Use the Generate Image operation to create an initial image
2. Pass the image URL to a Generate Variations operation
3. Create multiple variations of your base image

API Response

The node returns structured data containing:

• Generated image URLs or Base64 data
• Generation metadata (seed, steps, etc.)
• Task IDs for async operations
• Error information if generation fails

Compatibility

• Requires n8n version 0.174.0 or later
• Compatible with n8n cloud and self-hosted instances
• Supports both synchronous and asynchronous generation modes

Support

For issues and feature requests, please visit the GitHub repository or the n8n community forum.

License

MIT License - see LICENSE file for details.