Start building

HiDream O1

hidream-ai/hidream-o1

Hidream O1 by hidream-ai - generate stunning images from text prompts with state-of-the-art AI. Supports multiple aspect ratios, styles, and high-resolution output for creative and commercial use.

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

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

Optional reference images. Use none for text-to-image, one for image editing, or multiple for subject-driven personalization.
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
Execution
async
API
Unified Run API
Endpoint
/v1/run

API README

HiDream O1

hidream-ai/hidream-o1 uses reasoning-oriented visual generation to plan and synthesize images from complex written intent. HiDream-O1 focuses on understanding multi-step creative instructions and relationships before rendering, helping intricate compositions remain logically and visually coherent. 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, it fits visual problem solving, structured layouts, complex concept scenes, and briefs with several interacting requirements that are difficult for straightforward prompt matching. 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

Reasoning-led composition plans complex visual relationships before synthesis.

Multi-step instruction following handles briefs containing several linked requirements.

Spatial coherence maintains logical placement, interaction, and scene structure.

Detailed rendering converts the planned visual solution into polished imagery.

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": "16:9",
  "images": [
    "https://static.sandbase.ai/examples/hidream-ai/hidream-o1/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
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
# Preserve Unicode and shell metacharacters in the request body.
result=$(printf '%s' 'ewogICJtb2RlbCI6ICJoaWRyZWFtLWFpL2hpZHJlYW0tbzEiLAogICJpbWFnZXMiOiBbCiAgICAiaHR0cHM6Ly9zdGF0aWMuc2FuZGJhc2UuYWkvZXhhbXBsZXMvaGlkcmVhbS1haS9oaWRyZWFtLW8xL2lucHV0X3JlZmVyZW5jZV9pbWFnZV91cmxzXzAucG5nIgogIF0sCiAgInByb21wdCI6ICJBIGNpbmVtYXRpYyBwcm9kdWN0IHBob3RvIG9mIGEgY2VyYW1pYyBtdWcgb24gYSBtYXJibGUgY291bnRlciB3aXRoIHRoZSB3b3JkcyBcImZhbCBsb3ZlcyBIaURyZWFtXCIgcHJpbnRlZCBvbiB0aGUgbXVnLiIsCiAgImFzcGVjdF9yYXRpbyI6ICIxNjo5IiwKICAib3V0cHV0X2Zvcm1hdCI6ICJwbmciCn0=' \
  | 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 O1This model
HiDream		———May 9, 2026
HiDream O1 Dev
HiDream		———May 9, 2026
HiDream O1 Dev Edit
HiDream		———May 9, 2026
HiDream O1 Edit
HiDream		———May 9, 2026
HiDream I1 Fast
HiDream		———Apr 11, 2025
HiDream I1 Full
HiDream		———Apr 11, 2025