falText to imageComing soon

fal-ai/hidream-o1-image

Name: fal-ai/hidream-o1-image
Brand: fal

fal-ai/hidream-o1-image is a text to image tool from fal that runs in the background and returns images. Coming soon: listed with its price, not yet open to runs.

This tool is listed but not yet available to run.

Priced by usage

Pricing

$0.013 per megapixel. Each image_size preset counts as 1 MP, and a custom width × height rounds up to whole megapixels. Billed on num_images, default 1. The final charge comes from usage.

Limits

Runs: In the background
Returns: image
Longest queue wait: 3600s
Run deadline: 1800s
Largest inline input: 1024 KB
Largest input file: 500 MB
Largest output: 4768 MB
Outputs per run: 16

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."
    }
  }'