Readme
ICLight V2 - Advanced AI Image Relighting and Background Replacement
Transform your photos with professional lighting effects and background changes using ICLight V2, an advanced image-to-image model that re-lights photos and modifies backgrounds based on text descriptions.
Overview
ICLight V2 delivers exceptional image relighting and background replacement capabilities through an easy-to-use API. Whether you're enhancing product photography, creating artistic effects, or adjusting lighting for professional imagery, ICLight V2 provides the flexibility to transform your images while preserving important details.
Key Benefits
Transform your images with ICLight V2's powerful capabilities:
- Re-light photos with natural, professional-quality lighting effects
- Change backgrounds seamlessly based on text descriptions
- Preserve image details while applying sophisticated lighting modifications
- Flexible control over lighting direction and intensity
- Cost-effective pricing at $0.1 per megapixel
Getting Started
Getting up and running with ICLight V2 takes just a few minutes. Here's how:
- Install your preferred SDK:
JavaScript/TypeScript:
npm install --save @fal-ai/client
Python:
- Configure your API key:
import { fal } from "@fal-ai/client";
fal.config({
credentials: "YOUR_FAL_KEY_HERE"
});
- Transform your first image:
const result = await fal.subscribe("fal-ai/iclight-v2", {
input: {
image_url: "https://storage.googleapis.com/falserverless/iclight-v2/bottle.png",
prompt: "perfume bottle in a volcano surrounded by lava."
}
});
console.log(result.images[0].url);
API Parameters
ICLight V2 supports advanced parameters for fine-tuned control:
Required Parameters
image_url: URL of the input image to be re-litprompt: Text description of desired lighting/background
Optional Parameters
background_threshold: Threshold for background removal (default: 0.67)num_inference_steps: Number of denoising steps (default: 28)initial_latent: Initial latent state (default: "None")num_images: Number of images to generate (default: 1)cfg: CFG scale (default: 1)lowres_denoise: Low resolution denoise strength (default: 0.98)highres_denoise: High resolution denoise strength (default: 0.95)hr_downscale: High resolution downscale factor (default: 0.5)guidance_scale: Guidance scale for generation (default: 5)enable_safety_checker: Enable safety checks (default: true)output_format: Output image format (default: "jpeg")
Advanced Usage
Example with custom parameters:
const result = await fal.subscribe("fal-ai/iclight-v2", {
input: {
image_url: "https://example.com/your-image.jpg",
prompt: "professional studio lighting with soft shadows, neutral background",
num_inference_steps: 30,
guidance_scale: 7,
num_images: 3,
output_format: "png"
}
});
// Process multiple variations
result.images.forEach((image, index) => {
console.log(`Variation ${index + 1}: ${image.url}`);
});
Use Cases
ICLight V2 excels in various applications:
Product Photography
- Enhance e-commerce product images with professional lighting
- Create multiple lighting variations for A/B testing
- Remove distracting backgrounds and replace with clean alternatives
Portrait Enhancement
- Adjust portrait lighting for more flattering results
- Change environmental lighting to match desired mood
- Create consistent lighting across photo series
Creative Projects
- Transform day scenes to night or golden hour
- Add dramatic lighting effects for artistic impact
- Create surreal environments with custom backgrounds
Best Practices
Maximize your results with these proven approaches:
- Clear Prompts: Be specific about lighting direction, intensity, and background elements
- High-Quality Input: Use well-exposed images for best results
- Experiment with Settings: Adjust denoise and guidance parameters for different effects
- Batch Processing: Generate multiple variations to find the perfect result
- Monitor Usage: Track megapixel consumption through the fal.ai dashboard
Queue Management
For handling requests asynchronously:
// Submit request
const { request_id } = await fal.queue.submit("fal-ai/iclight-v2", {
input: {
image_url: "https://example.com/image.jpg",
prompt: "dramatic sunset lighting with warm tones"
}
});
// Check status
const status = await fal.queue.status("fal-ai/iclight-v2", {
requestId: request_id
});
// Get result
const result = await fal.queue.result("fal-ai/iclight-v2", {
requestId: request_id
});
Technical Support
Our comprehensive support ensures your success:
- Detailed API documentation with code examples
- Active Discord community for peer support
- Regular model updates and improvements
- Enterprise support available
Pricing and Usage
- Cost: $0.1 per megapixel
- Transparent usage-based pricing that scales with your needs
- No hidden fees or minimum commitments
- Monitor usage through the fal.ai dashboard
View detailed pricing or contact sales for enterprise solutions.
Getting Support
We're here to help you succeed:
Sign up now at fal.ai and start enhancing your images with professional lighting and backgrounds using ICLight V2.
