Search, explore, and run fal.ai generative AI models (image generation, video, audio, 3D). Use when user wants to generate images, videos, or other media with AI models.
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Run 1000+ generative AI models on fal.ai.
$0$1$2$3$ARGUMENTSSave generated files to session folder:
mkdir -p ~/.fal/sessions/${CLAUDE_SESSION_ID}
Downloaded images/videos go to:
~/.fal/sessions/${CLAUDE_SESSION_ID}/Requires
FAL_KEYGet an API key from https://fal.ai/dashboard/keys Then: export FAL_KEY="your-key-here"
$0Search for models matching
$1curl -s "https://api.fal.ai/v1/models?q=$1&limit=15" \ -H "Authorization: Key $FAL_KEY" | jq -r '.models[] | "• \(.endpoint_id) — \(.metadata.display_name) [\(.metadata.category)]"'
For category search, use:
curl -s "https://api.fal.ai/v1/models?category=$1&limit=15" \ -H "Authorization: Key $FAL_KEY" | jq -r '.models[] | "• \(.endpoint_id) — \(.metadata.display_name)"'
Categories:
text-to-imageimage-to-videotext-to-videoimage-to-3dtrainingspeech-to-texttext-to-speechGet input schema for model
$1curl -s "https://api.fal.ai/v1/models?endpoint_id=$1&expand=openapi-3.0" \ -H "Authorization: Key $FAL_KEY" | jq '.models[0].openapi.components.schemas.Input.properties'
Show required vs optional fields to help user understand what inputs are needed.
Run model
$1Step 1: Parse parameters Extract
--key value$ARGUMENTSExample:
/fal run fal-ai/flux-2 --prompt "a cat" --image_size landscape_16_9fal-ai/flux-2{"prompt": "a cat", "image_size": "landscape_16_9"}Step 2: Submit to queue
curl -s -X POST "https://queue.fal.run/$1" \ -H "Authorization: Key $FAL_KEY" \ -H "Content-Type: application/json" \ -d '<JSON_PAYLOAD>'
Step 3: Poll until complete
# Get request_id from response, then poll: while true; do STATUS=$(curl -s "https://queue.fal.run/$1/requests/$REQUEST_ID/status" \ -H "Authorization: Key $FAL_KEY" | jq -r '.status') echo "Status: $STATUS" if [ "$STATUS" = "COMPLETED" ]; then break; fi if [ "$STATUS" = "FAILED" ]; then echo "Job failed"; break; fi sleep 3 done
Step 4: Get result and save
# Fetch result RESULT=$(curl -s "https://queue.fal.run/$1/requests/$REQUEST_ID" \ -H "Authorization: Key $FAL_KEY")Create session output folder
mkdir -p ~/.fal/sessions/${CLAUDE_SESSION_ID}
Download images/videos
For images: jq -r '.images[0].url' and curl to download
Save as: ~/.fal/sessions/${CLAUDE_SESSION_ID}/<timestamp>_<model>.png
Check status of request
$2$1curl -s "https://queue.fal.run/$1/requests/$2/status?logs=1" \ -H "Authorization: Key $FAL_KEY" | jq '{status: .status, queue_position: .queue_position, logs: .logs}'
Get result of completed request
$2$1curl -s "https://queue.fal.run/$1/requests/$2" \ -H "Authorization: Key $FAL_KEY" | jq '.'
Upload file
$1curl -s -X POST "https://fal.run/fal-ai/storage/upload" \ -H "Authorization: Key $FAL_KEY" \ -F "file=@$1"
Returns URL to use in model requests.
Popular models:
fal-ai/flux-2fal-ai/flux-2-profal-ai/kling-video/v2/image-to-videofal-ai/minimax/video-01/image-to-videofal-ai/whisperCommon parameters for text-to-image:
--prompt "description"--image_size landscape_16_9--num_images 1Example invocations:
/fal search video/fal schema fal-ai/flux-2/fal run fal-ai/flux-2 --prompt "a sunset over mountains"/fal status fal-ai/flux-2 abc-123/fal upload ./photo.pngNo automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.