Start building

HiDream O1 Edit

hidream-ai/hidream-o1/edit

Hidream O1 Edit is hidream-ai's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.

Use in agentGet API key
Base price
$0.01 / run
Execution
async
Model type
image
Input fields
5

Try the model

Playground

Open playground
Input
Text prompt for image generation, editing, or subject-driven personalization.

PNG, JPEG, WebP, or GIF · 20 MiB maximum each

Reference images for image editing or subject-driven personalization.
The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.
Random seed for reproducible generation.
The format of the generated image. Allowed values: jpeg, png.
OutputReady

Your output will appear here

Complete the inputs, then click Run.

Specifications

Pricing

Base price
$0.01 / run

Context & modalities

Input
Schema-defined
Output
image

Capabilities

Chat
Not supported
Vision
Not supported
Reasoning
Not supported
Structured output
Not supported
Function calling
Not supported
Audio input
Not supported

Access

Provider
HiDream
Model ID
hidream-ai/hidream-o1/edit
Execution
async
API
Unified Run API
Endpoint
/v1/run

API README

HiDream O1 Edit

hidream-ai/hidream-o1/edit revises supplied images from written instructions while keeping requested subjects, identity, and scene structure recognizable. The HiDream editing workflow combines semantic source understanding with generative reconstruction, supporting changes that go beyond simple color correction or geometric transforms. This combination makes the model a practical choice when the creative outcome depends on those qualities rather than on a generic media conversion.

For production work with hidream-ai/hidream-o1/edit, it is useful for restyling, product variants, object replacement, background changes, and creative retouching when the original asset remains the foundation. The result is most reliable when the source material and creative brief clearly describe the intended subject, progression, visual or sonic character, and the qualities that must remain unchanged.

Highlights

Semantic image editing interprets natural-language changes in the context of the source scene.

Identity and structure preservation retain important subjects and unaffected composition.

Generative reconstruction blends changed objects, materials, and lighting coherently.

Creative revision supports restyling, replacement, background changes, and cleanup.

Pricing

Billing unitPrice
Per request$0.01

When to Use

✅ Good fit❌ Consider alternatives
The model's named workflow matches the source material and intended outputA different input modality or model route is required
A managed asynchronous result is suitable for the production pipelineA synchronous, interactive editor is essential
The documented controls cover the required duration, framing, or formatThe project needs controls outside this endpoint's schema
Creative iteration benefits from a repeatable request structureExact deterministic pixels, frames, geometry, or samples are mandatory
A finished downloadable media asset is the desired deliverableEditable source layers or a native project file are required

Prompt Guide

For generation, state the intended result first, then add the subject or source treatment, progression, style, and delivery constraints. Keep one creative variable per phrase, use the documented field names for controls, and change one setting at a time when comparing results.

{
  "aspect_ratio": "21:9",
  "images": [
    "https://static.sandbase.ai/examples/hidream-ai/hidream-o1/edit/input_reference_image_urls_0.png"
  ],
  "output_format": "png",
  "prompt": "A cinematic product photo of a ceramic mug on a marble counter with the words \"fal loves HiDream\" printed on the mug."
}

Technical Specs

SpecValue
Model IDhidream-ai/hidream-o1/edit
Inputsaspect_ratio, images, output_format, prompt, seed
Required inputsprompt
Output fieldscontent_type, url
ExecutionAsync (submit, then poll for result)
Aspect Ratio21:9 / 16:9 / 3:2 / 4:3 / 5:4 / 1:1 / 4:5 / 3:4 / 2:3 / 9:16
Output Formatjpeg / png

Related Models

Start building

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

Production API
Endpoint
https://api.sandbase.ai/v1/run
Model ID
hidream-ai/hidream-o1/edit
# Preserve Unicode and shell metacharacters in the request body.
result=$(printf '%s' 'ewogICJtb2RlbCI6ICJoaWRyZWFtLWFpL2hpZHJlYW0tbzEvZWRpdCIsCiAgImltYWdlcyI6IFsKICAgICJodHRwczovL3N0YXRpYy5zYW5kYmFzZS5haS9leGFtcGxlcy9oaWRyZWFtLWFpL2hpZHJlYW0tbzEvZWRpdC9pbnB1dF9yZWZlcmVuY2VfaW1hZ2VfdXJsc18wLnBuZyIKICBdLAogICJwcm9tcHQiOiAiQSBjaW5lbWF0aWMgcHJvZHVjdCBwaG90byBvZiBhIGNlcmFtaWMgbXVnIG9uIGEgbWFyYmxlIGNvdW50ZXIgd2l0aCB0aGUgd29yZHMgXCJmYWwgbG92ZXMgSGlEcmVhbVwiIHByaW50ZWQgb24gdGhlIG11Zy4iLAogICJvdXRwdXRfZm9ybWF0IjogInBuZyIKfQ==' \
  | base64 --decode \
  | curl --fail-with-body --silent \
      -X POST "https://api.sandbase.ai/v1/run" \
      -H "Authorization: Bearer $SANDBASE_API_KEY" \
      -H "Content-Type: application/json" \
      --data-binary @-)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

Choose your model

Compare models

All language models
ModelContextInput / 1MOutput / 1MReleased
HiDream O1 EditThis model
HiDream		———May 9, 2026
HiDream O1
HiDream		———May 9, 2026
HiDream O1 Dev
HiDream		———May 9, 2026
HiDream O1 Dev Edit
HiDream		———May 9, 2026
HiDream I1 Fast
HiDream		———Apr 11, 2025
HiDream I1 Full
HiDream		———Apr 11, 2025