Image Relighting

curl -X POST https://sense.eachlabs.run/chat \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "message": "Add professional studio lighting to this portrait - soft key light from the left with subtle fill",
    "image_urls": ["https://example.com/portrait.jpg"],
    "mode": "max"
  }'

Lighting Types Reference

Use Case Examples

1. Add Studio Lighting

Transform a casual photo into a professionally lit portrait with classic three-point lighting setup.

curl -X POST https://sense.eachlabs.run/chat \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "message": "Add professional studio lighting to this portrait. Use a soft key light from 45 degrees left, fill light from the right to reduce shadows, and a subtle hair light from behind. Keep the background dark for a classic studio look.",
    "image_urls": ["https://example.com/portrait.jpg"],
    "mode": "max"
  }'

2. Golden Hour / Sunset Lighting

Add warm, golden sunlight effect as if the photo was taken during the magic hour.

curl -X POST https://sense.eachlabs.run/chat \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "message": "Relight this photo with golden hour lighting. Add warm, soft sunlight coming from the side, creating a beautiful golden glow on the skin. Include subtle lens flare and that magical sunset atmosphere.",
    "image_urls": ["https://example.com/outdoor-photo.jpg"],
    "mode": "max"
  }'

3. Dramatic Side Lighting

Create bold, dramatic portraits with strong directional light and deep shadows.

curl -X POST https://sense.eachlabs.run/chat \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "message": "Apply dramatic side lighting to this portrait. Strong directional light from the left creating deep shadows on the right side of the face. High contrast, moody atmosphere, like a film noir character portrait.",
    "image_urls": ["https://example.com/headshot.jpg"],
    "mode": "max"
  }'

4. Soft Diffused Lighting

Create flattering, even lighting that minimizes harsh shadows and skin imperfections.

curl -X POST https://sense.eachlabs.run/chat \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "message": "Relight this photo with soft, diffused lighting. Like shooting through a large softbox or on an overcast day. Even, flattering light with minimal shadows, perfect for beauty photography. Keep the skin looking natural and glowing.",
    "image_urls": ["https://example.com/beauty-shot.jpg"],
    "mode": "max"
  }'

5. Neon / Colored Lighting

Add vibrant, creative colored lighting for editorial or artistic effects.

curl -X POST https://sense.eachlabs.run/chat \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "message": "Add neon lighting to this portrait. Cyberpunk style with pink/magenta light from the left and blue/cyan light from the right. Create that futuristic nightclub vibe with vibrant colored reflections on the skin and a dark background.",
    "image_urls": ["https://example.com/model-photo.jpg"],
    "mode": "max"
  }'

6. Natural Window Light

Simulate beautiful, soft natural light coming through a window.

curl -X POST https://sense.eachlabs.run/chat \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "message": "Relight this portrait with natural window light. Soft, directional daylight coming from a large window on the left side. Create gentle shadows and that beautiful, airy natural light photographers love. Slightly cool color temperature.",
    "image_urls": ["https://example.com/indoor-portrait.jpg"],
    "mode": "max"
  }'

7. Ring Light Effect

Add the signature ring light look popular in beauty and social media content.

curl -X POST https://sense.eachlabs.run/chat \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "message": "Apply ring light effect to this selfie. Even, frontal lighting with that signature circular catchlight in the eyes. Minimize shadows under the nose and chin, create that beauty influencer look with glowing, even skin illumination.",
    "image_urls": ["https://example.com/selfie.jpg"],
    "mode": "max"
  }'

8. Cinematic Lighting

Create movie-quality lighting with dramatic contrast and atmosphere.

curl -X POST https://sense.eachlabs.run/chat \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "message": "Apply cinematic lighting to this portrait. Hollywood movie style with strong key light, deep shadows, and subtle rim light separating the subject from background. Moody and atmospheric like a scene from a thriller. Add subtle haze/atmosphere in the air.",
    "image_urls": ["https://example.com/actor-photo.jpg"],
    "mode": "max"
  }'

9. Remove Harsh Shadows

Fix poorly lit photos by softening or removing unflattering harsh shadows.

curl -X POST https://sense.eachlabs.run/chat \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "message": "Remove the harsh shadows from this photo. The midday sun created unflattering dark shadows under the eyes and nose. Relight it with softer, more even lighting while keeping a natural outdoor look. Fill in the shadow areas without making it look flat.",
    "image_urls": ["https://example.com/harsh-shadow-photo.jpg"],
    "mode": "max"
  }'

10. Match Lighting to Background

Adjust subject lighting to seamlessly match a new environment or composited background.

curl -X POST https://sense.eachlabs.run/chat \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "message": "Relight this person to match the beach sunset background. The subject was photographed indoors with flat lighting, but needs to look like they are actually on the beach during golden hour. Match the warm color temperature, add rim lighting from the setting sun behind them, and ensure the shadows are consistent with the background lighting direction.",
    "image_urls": [
      "https://example.com/subject-indoor.jpg",
      "https://example.com/beach-sunset-background.jpg"
    ],
    "mode": "max"
  }'

Multi-Turn Lighting Refinement

Use session_id to iteratively refine lighting across multiple requests:

# Initial relighting
curl -X POST https://sense.eachlabs.run/chat \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "message": "Add dramatic studio lighting to this portrait with strong shadows",
    "image_urls": ["https://example.com/portrait.jpg"],
    "session_id": "lighting-session-001"
  }'

# Refine the result
curl -X POST https://sense.eachlabs.run/chat \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "message": "The shadows are too harsh. Can you soften them slightly while keeping the dramatic feel? Also add a subtle blue rim light on the shadow side.",
    "session_id": "lighting-session-001"
  }'

# Try a variation
curl -X POST https://sense.eachlabs.run/chat \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "message": "Create another version with warmer color temperature, like tungsten lighting",
    "session_id": "lighting-session-001"
  }'

Mode Selection

Ask your users before generating:

"Do you want fast & cheap, or high quality?"

Prompt Tips for Best Results

When requesting relighting, include these details for best results:

1. Light Direction: Specify where the light is coming from (left, right, above, behind)
2. Light Quality: Hard/soft, diffused, specular
3. Color Temperature: Warm (golden), cool (blue), neutral, or specific colors
4. Shadow Intensity: Deep shadows, subtle shadows, shadowless
5. Mood/Atmosphere: Dramatic, romantic, professional, edgy
6. Reference Style: "Like a Vogue editorial" or "Film noir style"

Example Prompt Structure

"Relight this [subject type] with [lighting style].
Light coming from [direction] with [quality] shadows.
[Color temperature] color temperature.
Mood: [atmosphere description].
[Additional requirements]"

Error Handling

Related Skills

• each-sense - Core API documentation
• product-photo-generation - E-commerce product lighting
• portrait-enhancement - Portrait retouching and enhancement
• background-replacement - Change backgrounds with matched lighting