Hidream O1 Image
fal-ai/hidream-o1-imageGenerate 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.013 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
| Field | Kind | Default | Description |
|---|---|---|---|
prompt required | text | — | Text prompt for image generation, editing, or subject-driven personalization. |
reference_image_urls | URLs or files | [] | Optional reference images. Use none for text-to-image, one for image editing, or multiple for subject-driven personalization. |
image_size | JSON | {"width":1024,"height":1024} | Requested output image size. Dimensions are rounded down to a multiple of 32, up to about 2048x2048 pixels. |
num_inference_steps | number (whole) 1 to 50 | 50 | Number of denoising steps. |
guidance_scale | number 0 to 20 | 5 | Classifier-free guidance scale. The full model uses 5.0 by default. |
seed | number (whole) | — | Random seed for reproducible generation. |
num_images | number (whole) 1 to 4 | 1 | Number of images to generate. |
output_format | one of jpeg, png, webp | png | The format of the generated image. |
keep_original_aspect | true or false | false | 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",
"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.013 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"` 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.