# 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
- Supported Modes: Image Edit

## API Parameters

The compiled parameter schema for this model is available via the API: `GET /v1/models/hidream-e1-1?schema=true`.

### Size & Layout

- `size` (string): Image dimensions as WxH pixels (e.g. "1024x1024") or aspect ratio (e.g. "16:9")
- `aspect_ratio` (string): Aspect ratio of the output image (e.g. "16:9", "1:1")
- `resolution` (string): Output resolution tier (e.g. "1K", "4K")

### Media Inputs

- `image` (file) — REQUIRED: Input image(s) to edit

### Output & Format

- `response_format` (string): How to return the image. Default: url. Values: url, b64_json
- `output_format` (string): Output image format. Values: png, jpeg, gif, webp, avif
- `output_compression` (integer): Compression level for lossy formats (JPEG, WebP, AVIF)
- `n` (integer): Number of images to generate. Default: 1


## Model Identifiers

- Primary Slug: hidream-e1-1


## Tags

image-generation, image-editing

## Available Providers

### fal.ai

- Config Key: fal/hidream-e1-1
- Provider Model ID: fal-ai/hidream-e1-1
- Pricing: $0.060/image
  - Source: https://fal.ai/models/fal-ai/hidream-e1-1


## Image Gallery

1 images available for this model. Browse all at https://lumenfall.ai/models/hidream-ai/hidream-e1-1/gallery

### Curated Examples

- [Cinematic wide shot of a high-end, artisan perfumery workshop. In the center, a single, elegantly...](https://assets.lumenfall.ai/uTtN_ug2nVDVSpm_jLKW-ztKUVmgoAzMPwa3Pl3-Dms/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/jxr85mg7oiirnybqtls92nyxviob@jpeg)

## 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

### Image Edit (/v1/images/edits)

#### 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