falText to imageComing soon

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

fal-ai/hunyuan-image/v3/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.13 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 for image-to-image.
negative_prompttextThe negative prompt to guide the image generation away from certain concepts.
image_sizeJSONsquare_hdThe desired size of the generated image.
num_imagesnumber (whole)
1 to 4
1The number of images to generate.
num_inference_stepsnumber (whole)
1 to 50
28Number of denoising steps.
guidance_scalenumber
1 to 20
7.5Controls how much the model adheres to the prompt. Higher values mean stricter adherence.
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.
enable_prompt_expansiontrue or falsefalseWhether to enable prompt expansion. This will use a large language model to expand the prompt with additional details while maintaining the original meaning.

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/text-to-image",
    "input": {
      "prompt": "200mm telephoto through crowd gaps; subject laughing, candid; creamy background compression, color pop from a single bold garment, catchlight in eyes."
    }
  }'