# FLUX Image Generator - Text to Image, Bulk Prompts (`seemuapps/flux-image-generator`) Actor

Generate images from text prompts in bulk with FLUX. Square, portrait, landscape, and wide formats, up to 4 images per prompt, with stable hosted output URLs ready to export.

- **URL**: https://apify.com/seemuapps/flux-image-generator.md
- **Developed by:** [Andrew](https://apify.com/seemuapps) (community)
- **Categories:** AI, Developer tools
- **Stats:** 25 total users, 9 monthly users, 74.6% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.00005 / actor start

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

## FLUX Image Generator - Text to Image

Turn text prompts into high quality images. Generate one image or hundreds in a single run, choose from fast FLUX models or premium Gemini and GPT image models, and get every image hosted on a stable URL you can drop straight into a sheet, CMS, or app.

### Models

- **FLUX schnell** - fastest and lowest cost, great for bulk runs
- **FLUX dev** - higher quality FLUX
- **Gemini 2.5 Flash Image / Nano Banana** and **Gemini 3 Flash Image / Nano Banana 2**
- **Gemini 3 Pro Image** - premium quality
- **GPT-5 Image** and **GPT-5 Image mini**

FLUX models are fast and cheap; the Gemini and GPT image models produce premium results at a higher cost per image.

### What you get

- A generated image for every prompt
- Square, portrait, landscape, wide, and tall aspect ratios
- Up to 4 variations per prompt
- A stable hosted image URL for each result, plus the prompt, model, provider, and dimensions in one clean row
- Optional fixed seed for reproducible results on FLUX models

### Use cases

- Blog, ad, and social media visuals at scale
- Product and concept mockups from a list of ideas
- Thumbnails and hero images for content pipelines
- Bulk creative testing across many prompts at once

### How to use

1. Add one or more **Prompts**, one image idea per line
2. Pick a **Model**: FLUX schnell for fast and cheap, FLUX dev for higher quality
3. Choose an **Aspect ratio** and **Images per prompt**
4. Optionally set an **Output format** and a fixed **Seed**
5. Run the actor. Each image appears as a row in the **Dataset** tab, and the files live in the **Key-value store**

### Input example

```json
{
  "prompts": [
    "A golden retriever puppy in a field of sunflowers, soft morning light, photorealistic",
    "Minimal product shot of a matte black water bottle on a marble surface"
  ],
  "model": "flux-schnell",
  "aspectRatio": "1:1",
  "imagesPerPrompt": 1,
  "outputFormat": "jpeg"
}
```

### Output example

```json
{
  "prompt": "A golden retriever puppy in a field of sunflowers, soft morning light, photorealistic",
  "model": "flux-schnell",
  "aspectRatio": "1:1",
  "width": 1024,
  "height": 1024,
  "imageIndex": 1,
  "imageUrl": "https://api.apify.com/v2/key-value-stores/STORE_ID/records/image_1_1.jpeg",
  "imageKey": "image_1_1.jpeg",
  "nsfw": false,
  "seed": null,
  "status": "success",
  "error": null
}
```

### Free tier

You can try this actor for free, with limits:

- Up to **3 images** per run, generated on the fast **FLUX schnell** model
- **3 runs per day**, with a **30-minute cooldown** between runs

Upgrade to a paid plan to use every model (including the premium Gemini and GPT image models), generate up to 4 images per prompt across 25 prompts, and run without daily limits or cooldowns.

### Notes

- The `imageUrl` is a stable, public link to the file in this run's key-value store. Download it or reference it directly.
- Each prompt is generated independently, so one bad prompt never stops the rest of the run. Failed prompts come back with `status` set to `error` and a short message.
- Use a fixed `seed` when you want the same prompt to produce the same image across runs.

# Actor input Schema

## `prompts` (type: `array`):

One or more text prompts describing the images to generate. Each prompt produces its own image (or several, see Images per prompt).

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

Which image model to use. FLUX models are fast and low cost. Gemini and GPT image models produce premium quality at a higher cost per image.

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

Shape of the generated images.

## `imagesPerPrompt` (type: `integer`):

How many images to generate for each prompt (1 to 4).

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

File format of the generated images. Applies to FLUX models; Gemini and GPT image models return their native format (usually PNG).

## `seed` (type: `integer`):

Optional fixed seed for reproducible results. Supported by FLUX models only; ignored by Gemini and GPT image models.

## Actor input object example

```json
{
  "prompts": [
    "A golden retriever puppy sitting in a field of sunflowers, soft morning light, photorealistic"
  ],
  "model": "flux-schnell",
  "aspectRatio": "1:1",
  "imagesPerPrompt": 1,
  "outputFormat": "jpeg"
}
```

# Actor output Schema

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

One record per generated image. Fields: prompt, model, aspectRatio, width, height, imageIndex, imageUrl (stable hosted URL), imageKey, sourceUrl, nsfw, seed, status, error.

# 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 = {
    "prompts": [
        "A golden retriever puppy sitting in a field of sunflowers, soft morning light, photorealistic"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("seemuapps/flux-image-generator").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 = { "prompts": ["A golden retriever puppy sitting in a field of sunflowers, soft morning light, photorealistic"] }

# Run the Actor and wait for it to finish
run = client.actor("seemuapps/flux-image-generator").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 '{
  "prompts": [
    "A golden retriever puppy sitting in a field of sunflowers, soft morning light, photorealistic"
  ]
}' |
apify call seemuapps/flux-image-generator --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,seemuapps/flux-image-generator"
        }
    }
}

```

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/eA9Ggxwcbi6kU31b4/builds/gEidBq5WeVNbFvwtv/openapi.json