# HiDream E1

> HiDream AI's image-to-image editing model for instruction-based image modifications and transformations

## Quick Reference

- Model ID: hidream-e1-1
- Creator: HiDream AI
- Status: active
- Family: hidream
- Base URL: https://api.lumenfall.ai/openai/v1

## Specifications

- Input Modalities: text, image
- Output Modalities: image

## Model Identifiers

- Primary Slug: hidream-e1-1

## Dates


## Tags

image-generation, image-editing

## Available Providers

### fal.ai

- Config Key: fal/hidream-e1-1
- Provider Model ID: fal-ai/hidream-e1-1
- Pricing:
  - source: official
  - currency: USD
  - components: [{"type" => "output", "metric" => "image", "unit_price" => 0.06}]
  - source_url: https://fal.ai/models/fal-ai/hidream-e1-1
  - effective_at: 2025-12-30


## Image Gallery

1 images available for this model.
- Curated examples: 1
  - "Cinematic wide shot of a high-end, artisan perfumery workshop. In the center, a single, elegantly designed glass perf..."

## Example Prompt

The following prompt was used to generate an example image in our playground:

A sun-drenched Mediterranean villa balcony overlooking a turquoise sea, featuring a bowl of vibrant citrus fruit and a vintage film camera on a marble table, while a calm capybara naps in the soft dappled shadows of a nearby lemon tree.

## Code Examples

### Text to Image (Generation)

#### cURL

curl -X POST \
  https://api.lumenfall.ai/openai/v1/images/generations \
  -H "Authorization: Bearer $LUMENFALL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hidream-e1-1",
    "prompt": "A serene mountain landscape at sunset",
    "size": "1024x1024"
  }'

# Response:
# { "created": 1234567890, "data": [{ "url": "https://...", "revised_prompt": "..." }] }

#### JavaScript

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.lumenfall.ai/openai/v1'
});

const response = await client.images.generate({
  model: 'hidream-e1-1',
  prompt: 'A serene mountain landscape at sunset',
  size: '1024x1024'
});

// { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
console.log(response.data[0].url);

#### Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.lumenfall.ai/openai/v1"
)

response = client.images.generate(
    model="hidream-e1-1",
    prompt="A serene mountain landscape at sunset",
    size="1024x1024"
)

# { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
print(response.data[0].url)

### Image Editing

#### cURL

curl -X POST \
  https://api.lumenfall.ai/openai/v1/images/edits \
  -H "Authorization: Bearer $LUMENFALL_API_KEY" \
  -F "model=hidream-e1-1" \
  -F "image=@source.png" \
  -F "prompt=Add a starry night sky to this image" \
  -F "size=1024x1024"

# Response:
# { "created": 1234567890, "data": [{ "url": "https://...", "revised_prompt": "..." }] }

#### JavaScript

import OpenAI from 'openai';
import fs from 'fs';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.lumenfall.ai/openai/v1'
});

const response = await client.images.edit({
  model: 'hidream-e1-1',
  image: fs.createReadStream('source.png'),
  prompt: 'Add a starry night sky to this image',
  size: '1024x1024'
});

// { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
console.log(response.data[0].url);

#### Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.lumenfall.ai/openai/v1"
)

response = client.images.edit(
    model="hidream-e1-1",
    image=open("source.png", "rb"),
    prompt="Add a starry night sky to this image",
    size="1024x1024"
)

# { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
print(response.data[0].url)


## About

## Overview
HiDream E1 is an instruction-based image-to-image editing model developed by HiDream AI. It is designed to perform precise modifications and transformations on existing images based on natural language prompts. Unlike standard text-to-image models that generate visuals from scratch, E1 specializes in altering specific elements of a source image while maintaining the original context and structure.

## Strengths
*   **Instructional Precision:** Excels at following specific, action-oriented directives (e.g., "change the color of the shirt" or "add a sunset to the background") without redrawing the entire scene.
*   **Context Retention:** Demonstrates high fidelity in preserving the identity and spatial arrangement of unchanged elements within the source image.
*   **Stylistic Flexibility:** Capable of executing both photorealistic edits and more dramatic artistic transformations, such as converting a photograph into a specific painting style.
*   **Efficient Processing:** Optimized for rapid iterations, making it suitable for workflows that require multiple sequential edits to reach a final result.

## Limitations
*   **Complex Spatial Reconfiguration:** May struggle with edits that require moving objects to entirely new positions or changing camera angles significantly while maintaining consistency.
*   **Granular Detail Control:** While effective for broad modifications, it may occasionally overlook very fine-grained textural details or subtle lighting nuances during complex background swaps.
*   **Textual Rendering:** Like many image-based models, its ability to edit or generate coherent text within an image remains a secondary capability compared to its visual manipulation strengths.

## Technical Background
HiDream E1 is built on a diffusion-based architecture specifically tuned for image-to-image tasks. It utilizes a conditioning mechanism that balances the visual information from the input image with the semantic requirements of the text prompt. This approach allows the model to treat the original image as a structural guide rather than a mere suggestion, ensuring that edits feel integrated rather than overlaid.

## Best For
HiDream E1 is ideal for professional design workflows, social media content creation, and e-commerce product visualization where users need to iterate on existing assets. It is particularly effective for background replacement, wardrobe adjustments, and applying global style transfers to specific photographs.

HiDream E1 is available through Lumenfall’s unified API and playground, allowing developers to integrate these advanced editing capabilities into their applications with a single standardized interface.

## Frequently Asked Questions

### How much does HiDream E1 cost?

HiDream E1 starts at $0.06 per image through Lumenfall. Pricing varies by provider. Lumenfall does not add any markup to provider pricing.

### How do I use HiDream E1 via API?

You can use HiDream E1 through Lumenfall's OpenAI-compatible API. Send requests to the unified endpoint with model ID "hidream-e1-1". Code examples are available in Python, JavaScript, and cURL.

### Which providers offer HiDream E1?

HiDream E1 is available through fal.ai on Lumenfall. Lumenfall automatically routes requests to the best available provider.

## Links

- Model Page: https://lumenfall.ai/models/hidream-ai/hidream-e1-1
- About: https://lumenfall.ai/models/hidream-ai/hidream-e1-1/about
- Providers, Pricing & Performance: https://lumenfall.ai/models/hidream-ai/hidream-e1-1/providers
- API Reference: https://lumenfall.ai/models/hidream-ai/hidream-e1-1/api
- Benchmarks: https://lumenfall.ai/models/hidream-ai/hidream-e1-1/benchmarks
- Use Cases: https://lumenfall.ai/models/hidream-ai/hidream-e1-1/use-cases
- Gallery: https://lumenfall.ai/models/hidream-ai/hidream-e1-1/gallery
- Playground: https://lumenfall.ai/playground?model=hidream-e1-1
- API Documentation: https://docs.lumenfall.ai