Spiral gives your agent every tool with one account. Browse the tools →

falImageAvailable nowReleased 2026-05-08

Hidream O1 Image

fal-ai/hidream-o1-image/dev

Generate and edit images from text with Hidream O1 Image from fal through one Spiral API key. It runs in the background and returns images. Pay as you go, with no subscription.

Pricing

$0.0065 per megapixel. image_size presets count as 1 MP; custom sizes round up to whole megapixels. Billed on num_images, default 1.

Limits

Runs
In the background
Returns
image
Longest queue wait
1 hour
Run deadline
30 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
prompt requiredtext—

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

reference_image_urlsURLs or files[]

Optional reference images. Use none for text-to-image, one for image editing, or multiple for subject-driven personalization.

image_sizeJSON{"width":1024,"height":1024}

Requested output image size. Dimensions are rounded down to a multiple of 32, up to about 2048x2048 pixels.

num_inference_stepsnumber (whole)
1 to 28
28

Number of denoising steps. The dev model is distilled for 28 steps.

guidance_scalenumber
0 to 20
0

Classifier-free guidance scale. The dev model uses 0.0 by default.

seednumber (whole)—

Random seed for reproducible generation.

num_imagesnumber (whole)
1 to 4
1

Number of images to generate.

output_formatone of
jpeg, png, webp
png

The format of the generated image.

keep_original_aspecttrue or falsefalse

When exactly one reference image is provided, preserve its aspect ratio for the output image.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "fal-ai/hidream-o1-image/dev",
    "input": {
      "prompt": "A cinematic product photo of a ceramic mug on a marble counter, soft window light, shallow depth of field."
    }
  }'

Frequently asked questions

How much does Hidream O1 Image cost?

$0.0065 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. Billed on `num_images`, default 1. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Hidream O1 Image through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/hidream-o1-image/dev"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with fal to use Hidream O1 Image?

No. Spiral runs it on its own fal account and charges your Spiral balance.

Can my AI agent use Hidream O1 Image?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.