# AI Image Generator (MAI-Image 2.5 Flash & DALL-E 3/2) (`dev00/ai-image-generator-mai-image-2-5-flash-dall-e-3-2`) Actor

Enterprise multi-model AI image generation engine supporting MAI-Image-2.5-Flash, OpenAI DALL-E 3, Copilot Designer Turbo, custom aspect ratios, style presets, creation types, and quality controls in structured JSON format.

- **URL**: https://apify.com/dev00/ai-image-generator-mai-image-2-5-flash-dall-e-3-2.md
- **Developed by:** [dev00](https://apify.com/dev00) (community)
- **Categories:** AI, MCP servers, Agents
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$3.00 / 1,000 ai image generations

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## AI Image Generator (MAI Flash & DALL-E 3) - Apify Actor

Enterprise multi-model AI image generation engine supporting MAI-Image-2.5-Flash, OpenAI DALL-E 3, Copilot Designer Turbo, custom aspect ratios, style presets, creation types, and quality controls with converted JSON output.

***

### 🤖 Supported AI Models & Architecture Matrix

| Model Name | Internal ID (`model`) | Engine / Provider | Key Characteristics | Best Used For |
| :--- | :--- | :--- | :--- | :--- |
| **MAI-Image-2.5-Flash** | `flash` (or `mdl=10`) | Microsoft AI (MAI) | Ultra-fast rendering (5–12s), low latency, excellent at dynamic artistic styles & vivid color rendering. | Fast generation, web interfaces, rapid prototyping. |
| **DALL-E 3** | `dall-e-3` (or `mdl=dalle3`) | OpenAI Engine | Deep natural language understanding, complex scenes with multiple subjects, accurate in-image typography. | High-detail realistic scenes, typography, complex prompts. |
| **Copilot Designer Turbo** | `turbo` (or `mdl=turbo`) | Hybrid Refinement | Multi-pass refinement engine with lighting and texture upscaling. | Marketing creatives, banners, commercial graphics. |
| **DALL-E 2 Legacy** | `dalle2` | OpenAI Legacy | Original 512×512 diffusion architecture. | Legacy support & fast thumbnail rendering. |

***

### 🎨 Canvas Shape & Aspect Ratio Dimensions

| Aspect Ratio (`aspect_ratio`) | Output Resolution | Description & Use Case |
| :--- | :--- | :--- |
| `square` (or `1:1`) | **1024 × 1024 px** | Standard 1:1 Square ratio (Instagram posts, avatars, product cards) |
| `landscape` (or `3:2`) | **1248 × 832 px** | 3:2 Standard landscape ratio (Blog header hero images, photography) |
| `portrait` (or `2:3`) | **832 × 1248 px** | 2:3 Vertical portrait ratio (Mobile wallpapers, Pinterest pins, stories) |
| `widescreen` (or `16:9`) | **1248 × 702 px** | 16:9 Cinematic widescreen ratio (YouTube thumbnails, presentations) |

***

### 🚀 Key Features

- **Multi-Engine AI Generation**: Choose between fast rendering via MAI-Image-2.5-Flash and detailed rendering via DALL-E 3.
- **Custom Aspect Ratios**: Generate square, landscape, portrait, and widescreen artwork dynamically.
- **Curated Style Presets & Types**: Apply styles (`cyberpunk`, `photorealistic`, `anime`, `3d-render`, `oil-painting`) and creation types (`image`, `sticker`, `logo`).
- **High Speed & Enterprise Reliability**: Powered by smart HTTP engines for zero IP blocking and fast turnaround (<12s per prompt).

***

### 🎯 What People Use It For

- **E-Commerce & Marketing Agencies**: Create high-converting ad creative banners, social media posts, logos, and stickers.
- **Mobile & Web App Developers**: Integrate text-to-image AI capabilities into chatbots, photo tools, and mobile apps.
- **Content Creators & Bloggers**: Generate custom blog post headers, YouTube thumbnails, and article illustrations.
- **Prototyping & Design Systems**: Generate vector emblems, sticker sets, and UI asset placeholders on-demand.

***

### 📌 Decision Rule & Usage Recommendation

Check if `status === "success"` AND `total_images > 0`. Iterate through the returned `images` list to extract `image_url`, `hd_url`, and `thumbnail_url`.

***

### 💡 What Problem Does This Solve?

- *"Official DALL-E 3 API fees ($0.04 - $0.08 per image) are extremely expensive for high-volume apps."*
- *"Open-source Midjourney / Stable Diffusion setups require GPU infrastructure and complex prompt tuning."*
- *"Difficulty obtaining multi-model text-to-image generation in a single unified API payload."*

AI Image Generator delivers automated, low-latency, high-resolution AI artwork generation in a single API or Actor run.

***

### 🔍 Queries This Actor Answers

- *How do I generate DALL-E 3 and MAI Flash images programmatically in Python, Node.js, or Apify Actors?*
- *How do I create AI stickers, logos, and cyberpunk graphics using text prompts?*
- *What is an accurate low-latency alternative to Midjourney and OpenAI DALL-E 3 API?*
- *How do I generate widescreen and portrait AI images without GPU setup?*

***

### 📥 Input JSON Schema

Pass the prompt and optional model parameters in the input JSON:

```json
{
  "prompt": "majestic cybernetic lion guardian",
  "aspect_ratio": "square",
  "model": "flash",
  "style": "cyberpunk",
  "type": "image",
  "quality": "max"
}
```

***

### 📤 Dataset Output Format

Each run outputs a clean structured item to the default dataset and key-value store (`OUTPUT`):

```json
{
  "status": "success",
  "success": true,
  "service": "AI Image Generator Engine",
  "prompt": "majestic cybernetic lion guardian",
  "parameters": {
    "aspect_ratio": "1:1 Square",
    "width": 1024,
    "height": 1024,
    "model": "MAI-Image-2.5-Flash",
    "style": "cyberpunk",
    "quality": "100%",
    "type": "image"
  },
  "request_id": "1-6a8c63ed4a1a4b89b22484a678262ac4",
  "total_images": 4,
  "images": [
    {
      "id": 1,
      "thid": "OIG4._1SOMo52q.ZEFfKsDBDO",
      "image_url": "https://th.bing.com/th/id/OIG4._1SOMo52q.ZEFfKsDBDO?w=1024&h=1024&qlt=100&p=0&r=0&o=4&pid=ImgGn",
      "hd_url": "https://th.bing.com/th/id/OIG4._1SOMo52q.ZEFfKsDBDO?pid=ImgGn",
      "thumbnail_url": "https://th.bing.com/th/id/OIG4._1SOMo52q.ZEFfKsDBDO?w=150&h=150&qlt=70&p=0&r=0&o=4&pid=ImgGn",
      "width": 1024,
      "height": 1024
    }
  ]
}
```

***

### ⚠️ Failure Context & Error Handling

If an empty prompt string or invalid parameter is provided:

```json
{
  "success": false,
  "error": "Missing required parameter: 'prompt' string cannot be empty."
}
```

***

### 🏷️ Keywords

`ai image generator`, `text to image api`, `dall-e 3 api`, `mai flash image api`, `cyberpunk image generator`, `anime image generator`, `3d render generator`, `ai sticker generator`, `ai logo generator`, `photorealistic ai generator`, `midjourney alternative api`, `stable diffusion api`, `apify actor`.

# Actor input Schema

## `prompt` (type: `string`):

Detailed text description of the image to generate (e.g. 'majestic cybernetic lion guardian').

## `aspect_ratio` (type: `string`):

Canvas aspect ratio: 'square' (1:1), 'landscape' (3:2), 'portrait' (2:3), or 'widescreen' (16:9).

## `model` (type: `string`):

AI Model Engine: 'flash' (MAI-Image-2.5-Flash), 'dall-e-3' (OpenAI DALL-E 3), 'turbo' (Copilot Turbo), or 'dalle2' (DALL-E 2 Legacy).

## `style` (type: `string`):

Artistic style preset: 'default', 'cyberpunk', 'photorealistic', 'anime', '3d-render', or 'oil-painting'.

## `type` (type: `string`):

Creation type: 'image' (standard artwork), 'sticker' (die-cut vector outline), or 'logo' (minimalist emblem).

## `quality` (type: `string`):

Compression level: 'max' (100% uncompressed), 'hd' (70% web optimized), or 'low' (30% preview).

## Actor input object example

```json
{
  "prompt": "majestic cybernetic lion guardian",
  "aspect_ratio": "square",
  "model": "flash",
  "style": "default",
  "type": "image",
  "quality": "hd"
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `keyValueStoreResult` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "prompt": "majestic cybernetic lion guardian"
};

// Run the Actor and wait for it to finish
const run = await client.actor("dev00/ai-image-generator-mai-image-2-5-flash-dall-e-3-2").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "prompt": "majestic cybernetic lion guardian" }

# Run the Actor and wait for it to finish
run = client.actor("dev00/ai-image-generator-mai-image-2-5-flash-dall-e-3-2").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "prompt": "majestic cybernetic lion guardian"
}' |
apify call dev00/ai-image-generator-mai-image-2-5-flash-dall-e-3-2 --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dev00/ai-image-generator-mai-image-2-5-flash-dall-e-3-2"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/7yE7WGX2xzQyEv4zz/builds/9Pd2swdtv2jZx5jfe/openapi.json