Flux Image Generator

Generate high-quality AI images using NVIDIA's FLUX.1-dev model via NVIDIA NIM API. This Actor creates stunning visuals from text prompts with customizable dimensions and advanced generation parameters.

Features

• High-Quality Image Generation: Uses NVIDIA's state-of-the-art FLUX.1-dev model
• Customizable Dimensions: Supports multiple aspect ratios and sizes
• Flexible Parameters: Control inference steps, guidance scale, and random seed
• Multiple Output Formats: Base64 encoded images for easy integration
• Comprehensive Metadata: Detailed generation information with each image
• Error Handling: Robust error handling with informative messages

Quick Start

1. Get NVIDIA API Key: Obtain your API key from NVIDIA NIM
2. Set Environment Variable: Set NVIDIA_API_KEY in your Actor configuration
3. Run the Actor: Use the Apify platform or run locally with Apify CLI

Input Parameters

Parameter	Type	Required	Default	Description
prompt	string	✅	-	Text description of the desired image (max 4000 chars)
aspectRatio	string	❌	"1:1"	Aspect ratio for the image: 1:1, 16:9, 9:16, 3:2, 2:3
steps	integer	❌	20	Inference steps (1-50, higher = better quality)
cfgScale	number	❌	7.0	Guidance scale (1.0-20.0, higher = more prompt adherence)
seed	integer	❌	random	Random seed for reproducible results
outputFormat	string	❌	"base64"	Output format ("base64" or "url")

Output Format

Each generated image includes:

{
  "prompt": "Original input prompt text",
  "success": true,
  "timestamp": "2024-01-15T10:30:00.000Z",
  "imageData": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
  "metadata": {
    "width": 1024,
    "height": 1024,
    "steps": 20,
    "cfgScale": 7.0,
    "seed": 123456789,
    "model": "black-forest-labs/flux.1-dev",
    "apiResponseTime": 3500,
    "fileSize": 1250000
  }
}

Usage Examples

Basic Usage

{
  "prompt": "A beautiful sunset over the ocean with palm trees"
}

Advanced Usage

{
  "prompt": "A futuristic city with flying cars and neon lights, cyberpunk style, highly detailed",
  "aspectRatio": "16:9",
  "steps": 30,
  "cfgScale": 8.5,
  "seed": 123456
}

Pricing

This Actor is FREE to use - you only pay for the NVIDIA API usage based on your NIM subscription plan. Check NVIDIA NIM Pricing for current rates.

Limitations

• Image Size: Limited to supported dimensions (512×512 to 1344×1344)
• Prompt Length: Maximum 4000 characters
• Rate Limits: Subject to NVIDIA API rate limits
• File Format: PNG output only
• NSFW Content: Subject to NVIDIA's content policies

Integration Examples

Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run_input = {
    "prompt": "A majestic eagle soaring over mountains",
    "width": 1024,
    "height": 1024
}

actor_call = client.actor("YOUR_ACTOR_ID").call(run_input=run_input)
dataset = client.dataset(actor_call["defaultDatasetId"]).list_items()

JavaScript

const { ApifyClient } = require('apify-client');
const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const run = await client.actor('YOUR_ACTOR_ID').call({
  prompt: 'A serene forest path in autumn',
  width: 1344,
  height: 768
});

Support

• Documentation: NVIDIA FLUX Documentation
• API Reference: NVIDIA NIM API
• Issues: Report issues through Apify platform

Related Actors

• Artbreeder AI Image Creator - Uses different AI models
• Website Content Crawler - For collecting training data