DALL-E 2 - Image Variator

Create variations of existing images using OpenAI's DALL-E 2 model. This feature generates high-quality variations of your input image using advanced AI technology.

Image Upload Requirement

Before using this API, you must first upload your image using the Asset API. The imageUrl parameter should contain the file path returned from the Asset API upload response.

📖 See Asset API documentation for details on how to upload images.

Endpoint

POSThttps://api.1min.ai/api/features

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_VARIATOR`
`model`	string	Yes	AI model identifier. Must be `dall-e-2`
`imageUrl`	string	Yes	Path to uploaded image file (from Asset API)
`n`	number	No	Number of variations to generate (1-10, default: 1)
`size`	string	No	Generated image size (default: `1024x1024`)

Supported Image Sizes

Size	Resolution	Best For
1024x1024	1024×1024	High quality, detailed variations
512x512	512×512	Standard quality, faster generation
256x256	256×256	Quick previews, lower quality

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_VARIATOR",
"model": "dall-e-2",
"promptObject": {
  "imageUrl": "images/2025_10_26_05_43_42_184_cat.png",
  "n": 2,
  "size": "1024x1024"
}
}'

fetch('https://api.1min.ai/api/features', {
method: 'POST',
headers: {
  'Content-Type': 'application/json',
  'API-KEY': 'YOUR_API_KEY'
},
body: JSON.stringify({
  type: 'IMAGE_VARIATOR',
  model: 'dall-e-2',
  promptObject: {
    imageUrl: 'development/images/sample_image.jpeg',
    n: 2,
    size: '1024x1024'
  }
})
})

import requests

url = "https://api.1min.ai/api/features"
headers = {
"Content-Type": "application/json",
"API-KEY": "YOUR_API_KEY"
}

data = {
"type": "IMAGE_VARIATOR",
"model": "dall-e-2",
"promptObject": {
  "imageUrl": "images/2025_10_26_05_43_42_184_cat.png",
  "n": 2,
  "size": "1024x1024"
}
}

response = requests.post(url, headers=headers, json=data)

Interactive Playground

API Playground

https://api.1min.ai/api/features

AI Model *

Image URL *

Path to the uploaded image file (obtained from Asset API)

Number of Variations

Number of variations to generate (1-10)

Image Size

Resolution of generated images

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_VARIATOR",
  "model": "dall-e-2",
  "promptObject": {
    "imageUrl": "development/images/sample_image.jpeg",
    "n": 2,
    "size": "1024x1024"
  }
}'

Response Format

{
"aiRecord": {
  "uuid": "f69eff4d-0bb2-4ee0-b8ed-1bcd83edd839",
  "userId": "c937fbcc-fa8f-4565-a440-c4d87f56fcb2",
  "teamId": "a4e176b2-dabb-451e-9c58-62b451fa9630",
  "teamUser": {
    "teamId": "a4e176b2-dabb-451e-9c58-62b451fa9630",
    "userId": "c937fbcc-fa8f-4565-a440-c4d87f56fcb2",
    "userName": "John Doe",
    "userAvatar": "https://lh3.googleusercontent.com/a/ACg8ocLqgsNsHRfmWF9d-E1RvJetVsEzxNOsOg-NXWNTpMxLDPJbwELI=s96-c",
    "status": "ACTIVE",
    "role": "ADMIN",
    "creditLimit": 100000000,
    "usedCredit": 243000,
    "createdAt": "2025-10-20T04:13:40.847Z",
    "createdBy": "SYSTEM",
    "updatedAt": "2025-10-22T10:54:19.675Z",
    "updatedBy": "SYSTEM"
  },
  "model": "dall-e-2",
  "type": "IMAGE_VARIATOR",
  "metadata": null,
  "rating": null,
  "feedback": null,
  "conversationId": null,
  "status": "SUCCESS",
  "createdAt": "2025-10-22T11:00:49.338Z",
  "aiRecordDetail": {
    "promptObject": {
      "n": 2,
      "size": "1024x1024",
      "imageUrl": "images/2025_10_22_10_02_16_603_cat.png"
    },
    "resultObject": [
      "development/images/2025_10_22_18_01_12_252_494574.png",
      "development/images/2025_10_22_18_01_12_254_728072.png"
    ],
    "responseObject": {}
  },
  "additionalData": null,
  "temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2025_10_22_18_01_12_252_494574.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAVRUVQEFIHSKAXGE7%2F20251022%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20251022T110118Z&X-Amz-Expires=604800&X-Amz-Signature=39cfcca51a4198d18c3b1690bec5475beb3b388255e966846d08045ba492f4a7&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
}
}

Use Cases

Creative Exploration: Generate multiple interpretations of your artwork
Design Iterations: Create variations for logos, illustrations, or concept art
Content Creation: Develop diverse visual content for marketing materials
Art Direction: Explore different artistic styles and compositions
Prototyping: Quickly generate visual alternatives for design decisions

Tips for Best Results

Image Quality: Use clear, high-resolution input images for better results
Size Selection:
- Use 1024x1024 for final high-quality outputs
- Use 512x512 for standard quality and faster generation
- Use 256x256 for quick previews and iteration
Batch Processing: Generate multiple variations at once to explore different creative directions
Input Preparation: Ensure uploaded images are well-cropped and focused on the main subject

Notes

DALL-E 2 generates variations that maintain the core elements while introducing creative differences
All generated images are original creations and not copies of existing artwork
Processing time scales with image size and number of variations requested
The model works best with clear, well-defined subjects in the input image

Endpoint​

Request Headers​

Parameters​

Supported Image Sizes​

Code Examples​

Interactive Playground​