falText to imageComing soon

fal-ai/hunyuan-image/v3/instruct/text-to-image

fal-ai/hunyuan-image/v3/instruct/text-to-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.117 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

FieldKindDefaultDescription
prompt requiredtext—The text prompt to generate an image from.
image_sizeJSONautoThe desired size of the generated image. If auto, image size will be determined by the model.
num_imagesnumber (whole)
1 to 4
1The number of images to generate.
guidance_scalenumber
… to 20
3.5Controls how much the model adheres to the prompt. Higher values mean stricter adherence.
enable_prompt_expansiontrue or falsetrueIf set to true, the prompt will be expanded through the model's internal recaptioning step.
seednumber (whole)—Random seed for reproducible results. If None, a random seed is used.
output_formatone of
jpeg, png
pngThe format of the generated 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/hunyuan-image/v3/instruct/text-to-image",
    "input": {
      "prompt": "Macro photograph of a peacock feather showing individual barbs, barbules, and the iridescent microstructure creating color."
    }
  }'