GPT Image 1 - Image Generator
Generate premium quality images from text prompts using OpenAI's advanced GPT Image 1 model. Features enhanced understanding, superior image quality with flexible quality levels from low to high, and support for multiple aspect ratios.
Endpoint
Request Headers
| Field | Value |
|---|---|
| API-KEY | <api-key> |
| Content-Type | application/json |
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
type | string | Yes | Feature type identifier. Must be IMAGE_GENERATOR |
model | string | Yes | AI model identifier. Must be gpt-image-1 |
promptObject | object | Yes | Configuration object containing all generation parameters |
Prompt Object Parameters
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
prompt | string | Yes | Text description of the image to generate | - |
n | number | No | Number of images to generate (1-10) | 1 |
size | string | No | Image dimensions | 1024x1024 |
quality | string | No | Image quality level | medium |
style | string | No | Visual style of the generated image | vivid |
output_format | string | No | Output format for the generated image | png |
output_compression | number | No | Compression level (0-100, higher = better quality) | 85 |
background | string | No | Background mode for transparent subjects | opaque |
Supported Image Sizes
| Size | Resolution | Aspect Ratio | Best For |
|---|---|---|---|
1024x1024 | 1024×1024 | 1:1 | Square images, social media posts |
1024x1536 | 1024×1536 | 2:3 | Portrait orientation, tall images |
1536x1024 | 1536×1024 | 3:2 | Landscape orientation, wide images |
Quality Options
| Quality | Description | Use Case |
|---|---|---|
low | Fast, cost-effective generation | Quick prototypes, iterations |
medium | Balanced quality and speed | Most use cases, professional work |
high | Premium quality with maximum detail | Final artwork, premium content |
Style Options
| Style | Description | Visual Characteristics |
|---|---|---|
vivid | Vibrant and dramatic | High contrast, bold colors, artistic flair |
natural | More natural and realistic | Subtle colors, realistic lighting, photographic |
Output Format Options
| Format | Description | Best For |
|---|---|---|
png | Lossless format with transparency support | Professional use, highest quality |
jpeg | Compressed format | Web optimization, smaller files |
webp | Modern format with superior compression | Web applications |
Background Options
| Background | Description | Use Case |
|---|---|---|
opaque | Solid background (default) | Standard images, no transparency needed |
transparent | Transparent background for supported subjects | Logos, cutouts, compositing |
Code Examples
- cURL
- JavaScript
- Python
curl --location 'https://api.1min.ai/api/features' \
--header 'API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"type": "IMAGE_GENERATOR",
"model": "gpt-image-1",
"promptObject": {
"prompt": "A serene Japanese garden with cherry blossoms and a traditional tea house",
"n": 1,
"size": "1536x1024",
"quality": "high",
"style": "natural",
"output_format": "png",
"background": "opaque"
}
}'
fetch('https://api.1min.ai/api/features', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'API-KEY': 'YOUR_API_KEY'
},
body: JSON.stringify({
type: 'IMAGE_GENERATOR',
model: 'gpt-image-1',
promptObject: {
prompt: 'A serene Japanese garden with cherry blossoms and a traditional tea house',
n: 1,
size: '1536x1024',
quality: 'high',
style: 'natural',
output_format: 'png',
background: 'opaque'
}
})
})
import requests
url = "https://api.1min.ai/api/features"
headers = {
"Content-Type": "application/json",
"API-KEY": "YOUR_API_KEY"
}
data = {
"type": "IMAGE_GENERATOR",
"model": "gpt-image-1",
"promptObject": {
"prompt": "A serene Japanese garden with cherry blossoms and a traditional tea house",
"n": 1,
"size": "1536x1024",
"quality": "high",
"style": "natural",
"output_format": "png",
"background": "opaque"
}
}
response = requests.post(url, headers=headers, json=data)
Interactive Playground
API Playground
https://api.1min.ai/api/featuresDescribe the image you want to generate in detail
Number of images to generate (1-10)
Choose image dimensions and aspect ratio
Image quality level
Visual style of the generated image
Format of the output image
Compression level (0-100, higher = better quality)
Background mode for transparent subjects
Generated cURL Command:
curl -X POST "https://api.1min.ai/api/features" \
-H "API-KEY: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"type": "IMAGE_GENERATOR",
"model": "gpt-image-1",
"promptObject": {
"prompt": "A serene Japanese garden with cherry blossoms and a traditional tea house",
"n": 1,
"size": "1024x1024",
"quality": "medium",
"style": "natural",
"output_format": "png",
"background": "opaque"
}
}'
Response Format
{
"aiRecord": {
"uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"userId": "user-12345",
"teamId": "team-67890",
"teamUser": {
"teamId": "team-67890",
"userId": "user-12345",
"userName": "John Doe",
"userAvatar": "https://example.com/avatar.jpg",
"status": "ACTIVE",
"role": "ADMIN",
"creditLimit": 100000000,
"usedCredit": 42000,
"createdAt": "2025-01-01T00:00:00.000Z",
"createdBy": "SYSTEM",
"updatedAt": "2025-01-15T10:30:00.000Z",
"updatedBy": "SYSTEM"
},
"model": "gpt-image-1",
"type": "IMAGE_GENERATOR",
"metadata": null,
"rating": null,
"feedback": null,
"conversationId": null,
"status": "SUCCESS",
"createdAt": "2025-01-15T10:30:00.000Z",
"aiRecordDetail": {
"promptObject": {
"prompt": "A serene Japanese garden with cherry blossoms and a traditional tea house",
"n": 1,
"size": "1024x1024",
"quality": "medium",
"style": "natural",
"output_format": "png",
"background": "opaque"
},
"resultObject": [
"development/images/2025_01_15_10_30_15_001_japanese_garden.png"
],
"responseObject": {}
},
"additionalData": null,
"temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2025_01_15_10_30_15_001_japanese_garden.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=EXAMPLE_CREDENTIAL&X-Amz-Date=20250115T103000Z&X-Amz-Expires=604800&X-Amz-Signature=example_signature&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
}
}
Use Cases
- Creative Design: High-quality illustrations, concept art, and creative visuals
- Social Media Content: Eye-catching posts, stories, and promotional materials
- Marketing Assets: Product mockups, advertising visuals, and brand imagery
- Character Design: Character illustrations and visual storytelling
- Architecture Visualization: Conceptual building designs and interior layouts
- Publishing: Book covers, editorial illustrations, and graphic design
- Game Assets: Concept art and visual development for games