Skip to main content

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

FieldValue
API-KEY<api-key>
Content-Typeapplication/json

Parameters

ParameterTypeRequiredDescription
typestringYesFeature type identifier. Must be IMAGE_GENERATOR
modelstringYesAI model identifier. Must be gpt-image-1
promptObjectobjectYesConfiguration object containing all generation parameters

Prompt Object Parameters

ParameterTypeRequiredDescriptionDefault
promptstringYesText description of the image to generate-
nnumberNoNumber of images to generate (1-10)1
sizestringNoImage dimensions1024x1024
qualitystringNoImage quality levelmedium
stylestringNoVisual style of the generated imagevivid
output_formatstringNoOutput format for the generated imagepng
output_compressionnumberNoCompression level (0-100, higher = better quality)85
backgroundstringNoBackground mode for transparent subjectsopaque

Supported Image Sizes

SizeResolutionAspect RatioBest For
1024x10241024×10241:1Square images, social media posts
1024x15361024×15362:3Portrait orientation, tall images
1536x10241536×10243:2Landscape orientation, wide images

Quality Options

QualityDescriptionUse Case
lowFast, cost-effective generationQuick prototypes, iterations
mediumBalanced quality and speedMost use cases, professional work
highPremium quality with maximum detailFinal artwork, premium content

Style Options

StyleDescriptionVisual Characteristics
vividVibrant and dramaticHigh contrast, bold colors, artistic flair
naturalMore natural and realisticSubtle colors, realistic lighting, photographic

Output Format Options

FormatDescriptionBest For
pngLossless format with transparency supportProfessional use, highest quality
jpegCompressed formatWeb optimization, smaller files
webpModern format with superior compressionWeb applications

Background Options

BackgroundDescriptionUse Case
opaqueSolid background (default)Standard images, no transparency needed
transparentTransparent background for supported subjectsLogos, cutouts, compositing

Code Examples

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"
}
}'

Interactive Playground

API Playground

https://api.1min.ai/api/features
Describe 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