Search fal.ai Model Catalog
fal_list_modelsSearch and browse fal.ai's catalog of 600+ models to find the correct model ID for any task. Filter by category or keyword to discover the right generative AI model.
Instructions
Search or browse fal.ai's catalog of 600+ hosted models to find the right model id for a task. Does NOT run any model — this is discovery only.
Args:
query (string, optional): Keyword search, e.g. "flux", "upscale", "text to speech"
category (string, optional): Category filter, e.g. "text-to-image", "image-to-video"
limit (number): Maximum results to return, 1-100 (default: 20)
cursor (string, optional): Pagination cursor from a previous response's next_cursor
response_format ('markdown' | 'json'): Output format (default: markdown)
Returns: For JSON format: { "count": number, "models": [ { "endpoint_id": string, "title": string, "category": string, "short_description": string } ], "has_more": boolean, "next_cursor": string | null } For markdown format: a readable list of matching models with their ids.
Examples:
Use when: "What model should I use to generate a video?" -> query="video" or category="text-to-video"
Use when: "Find a background removal model" -> query="background removal"
Don't use when: you already know the exact model_id — go straight to fal_run_model or fal_submit_request
Error Handling:
Returns "No models found matching ''" if the search returns empty
Returns "Authentication failed" if FAL_KEY is missing or invalid
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum results to return (default: 20) | |
| query | No | Optional keyword search, e.g. "flux", "video", "upscale", "text to speech". | |
| cursor | No | Pagination cursor from a previous call's next_cursor field | |
| category | No | Optional category filter, e.g. "text-to-image", "image-to-video", "text-to-speech". | |
| response_format | No | Output format: 'markdown' for human-readable or 'json' for machine-readable (default: markdown) | markdown |