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