Readme
Transform your existing images into stunning visuals with FLUX.1 [dev] Image-to-Image, a high-performance endpoint that enables rapid transformation of existing images, delivering high-quality style transfers and image modifications with the core FLUX capabilities.
Overview
FLUX.1 Image-to-Image is built on the powerful 12-billion parameter FLUX.1 [dev] flow transformer, designed specifically for transforming existing images based on text prompts. The model excels at style transfers, image modifications, and artistic variations while preserving the core composition of the input image.
Key Capabilities
Image-to-Image Transformation
- Transform existing images using natural language descriptions
- High-quality style transfers and artistic modifications
- Preserve core composition while applying creative changes
- Support for various image formats: jpg, jpeg, png, webp, gif, avif
Performance Optimizations
- Rapid transformation with optimized inference pipeline
- Production-ready API with enterprise scalability
- Suitable for both personal and commercial use
- Consistent, high-quality results across multiple generations
Getting Started
Setting up FLUX.1 Image-to-Image is straightforward. First, install your preferred client library:
For JavaScript/TypeScript:
npm install --save @fal-ai/client
For Python:
Initialize the client with your API key:
import { fal } from '@fal-ai/client'
fal.config({
credentials: 'YOUR_API_KEY'
})
Making Your First API Call
Transform your first image with this example:
const result = await fal.subscribe('fal-ai/flux/dev/image-to-image', {
input: {
image_url: 'https://your-image-url.com/image.jpg',
prompt: 'Transform this into a watercolor painting style',
strength: 0.8
}
})
Best Practices
Maximize the quality of your image transformations:
Write Clear, Descriptive Prompts
Consider including specific details about the desired style, artistic direction, or modifications. For example, instead of "make it artistic", try "transform into a vibrant oil painting with visible brush strokes and rich colors".
- Use strength parameter to control how much the image changes (0.1 = minimal change, 1.0 = maximum transformation)
- Start with moderate strength values around 0.7-0.8 for most use cases
- Use consistent seeds when you need reproducible results
- Ensure input images are high quality for best results
- Supported formats: jpg, jpeg, png, webp, gif, avif
- Use drag-and-drop functionality or provide base64 encoded data URLs
Technical Specifications
Model Architecture
- 12 billion parameter FLUX.1 [dev] flow transformer
- Optimized for image-to-image transformations
- Commercial usage rights included
- High-performance inference pipeline
API Parameters
- image_url: Input image to transform (required)
- prompt: Text description of desired transformation (required)
- strength: Transformation intensity (default: 0.95)
- num_inference_steps: Generation steps (default: 40)
- guidance_scale: Prompt adherence (default: 3.5)
- seed: For reproducible results
- safety_checker: Content safety filtering (default: true)
- Optimized inference for rapid transformations
- Concurrent request handling capability
- Enterprise-grade reliability and uptime
Integration Support
Our comprehensive SDK support makes it easy to integrate FLUX.1 Image-to-Image into your existing workflow:
- Official JavaScript/TypeScript SDK
- Python client library
- REST API access with detailed documentation
- Comprehensive error handling and status monitoring
Documentation Resources
- Complete API reference documentation
- Code examples and integration tutorials
- Best practices guides
- Troubleshooting and support resources
Pricing and Usage
Your request will cost $0.03 per megapixel. Images are billed by rounding up to the nearest megapixel. Our transparent, usage-based pricing scales with your needs:
- Cost-effective: $0.03 per megapixel for image transformations
- Commercial usage rights included
- No subscription fees or minimum commitments
- Transparent billing with clear pricing structure
View detailed pricing or contact sales for enterprise solutions.
Use Cases
Style Transfer and Artistic Transformation
Convert photographs into paintings, sketches, or other artistic styles while maintaining the original composition and subject matter.
Image Enhancement and Modification
Modify lighting, colors, textures, or artistic direction of existing images based on natural language descriptions.
Creative Workflows
Ideal for designers, artists, and content creators who need to quickly explore different visual styles and modifications of existing images.
Commercial Applications
Perfect for marketing materials, social media content, and product imagery that requires style consistency or artistic enhancement.
Getting Help
We're here to support your implementation:
- Technical Documentation: Visit our detailed docs at https://docs.fal.ai/
- API Reference: Complete endpoint documentation and parameters
- Support: Contact our technical team for assistance
Start transforming your images with FLUX.1 [dev] Image-to-Image today and bring your creative visions to life with state-of-the-art image transformation capabilities.
Get Started Now | View Documentation | Try Image-to-Image
fal-ai/flux/dev/image-to-image
