Hidream E1 Full | Fast Image Editing API

HiDream E1 Full — wavespeed-ai/hidream-e1-full

HiDream E1 Full is a prompt-based image editing model for high-quality, identity-preserving edits from a single input image. Upload an image, describe the change you want (e.g., wardrobe, accessories, color tweaks, minor scene adjustments), and the model applies the edit while keeping the subject and overall composition stable. It’s ideal for practical photo edits and fast creative variations without rebuilding the entire image.

Key capabilities

Single-image, prompt-driven editing with strong subject preservation
Reliable for wardrobe and accessory changes (clothes, glasses, hats, etc.)
Maintains composition and lighting consistency for natural-looking results
Seed control for reproducible variations
Supports URL output or BASE64 output (API only)

Use cases

Outfit edits for portraits (change sweater color/style, add/remove accessories)
E-commerce variations (multiple product colorways or styling options)
Quick retouch-like changes (minor background tweaks, prop swaps)
Marketing creatives: generate multiple variants from one hero photo
Rapid iteration: try different looks by changing prompt or seed

Pricing

Output	Price
Per image edit	$0.024

Inputs

image (required): source image to edit
prompt (required): edit instruction (what to change)

Parameters

prompt: what to change (be explicit about what to keep)
image: input image (upload or URL)
seed: random seed (-1 for random; fixed for reproducible results)
output_format: output format (e.g., jpeg)
enable_base64_output: return BASE64 instead of URL (API only)

Prompting guide

For clean results, specify both the change and the constraints:

Template: Keep the same person, pose, and background. Change [target edit]. Keep lighting natural and consistent.

Example prompts

Keep the same person and pose. Change the outfit to a light gray sweater and add gold thin-rimmed glasses. Keep the background and lighting unchanged.
Keep identity and composition. Replace the jacket with a black leather jacket, keep realistic fabric texture and natural shadows.
Keep the subject unchanged. Remove the object on the table and keep the scene lighting consistent.

Hidream E1 Full API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/wavespeed-ai/hidream-e1-full with your input as JSON. The endpoint returns a prediction id. Start polling the result endpoint around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. On completed, read URLs from data.outputs. Examples for Hidream E1 Full below.

HTTP example

# Submit the prediction
curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/hidream-e1-full" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "image": "https://example.com/your-input.jpg",
    "seed": -1,
    "output_format": "jpeg",
    "enable_base64_output": false
}'

# Wait at least 2 seconds, then poll. Safe GET requests may be retried.
curl --fail-with-body --connect-timeout 10 --max-time 30 \
  --retry 4 --retry-all-errors --retry-delay 1 \
  -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# Start at 2 seconds and increase the interval for long-running tasks.
# Stop on completed, failed, cancelled, or timeout.

Node.js example

// npm install wavespeed
const { Client } = require('wavespeed');

const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
const client = new Client(apiKey);

try {
  const result = await client.run("wavespeed-ai/hidream-e1-full", {
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "image": "https://example.com/your-input.jpg",
        "seed": -1,
        "output_format": "jpeg",
        "enable_base64_output": false
}, {
    timeout: 3600,
    pollInterval: 2.0,
  });
  console.log(result.outputs);
} catch (error) {
  console.error('Generation failed:', error);
  process.exitCode = 1;
}

Python example

# pip install wavespeed
import os
from wavespeed import Client

client = Client(api_key=os.environ["WAVESPEED_API_KEY"])

try:
    output = client.run(
        "wavespeed-ai/hidream-e1-full",
        {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "image": "https://example.com/your-input.jpg",
    "seed": -1,
    "output_format": "jpeg",
    "enable_base64_output": false
},
        timeout=3600.0,
        poll_interval=2.0,
    )
    print(output["outputs"])
except Exception as error:
    raise SystemExit(f"Generation failed: {error}") from error

Hidream E1 Full API — Frequently asked questions

What is the Hidream E1 Full API?

Hidream E1 Full is a WaveSpeedAI model for image editing, exposed as a REST API on WaveSpeedAI. HiDream-E1 Full is an image editing model built on HiDream-I1 that delivers high-quality, content-aware edits and refinements. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Hidream E1 Full API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID. Poll the result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. The playground generates production-oriented Python, JavaScript, and cURL examples with timeouts, transient-error handling, and safe GET retries. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/wavespeed-ai/hidream-e1-full.

How much does Hidream E1 Full cost per run?

Hidream E1 Full starts at $0.024 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Hidream E1 Full accept?

Key inputs: `prompt`, `image`, `seed`, `enable_base64_output`, `output_format`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/wavespeed-ai/hidream-e1-full.

How long does Hidream E1 Full take to generate?

Average end-to-end generation time on WaveSpeedAI is around 13 seconds per request — measured across recent runs. Queue time scales with global demand; live status is visible in the prediction record.

Can I use Hidream E1 Full outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (WaveSpeedAI). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

PrzykładyZobacz wszystkie

Powiązane modele

README