Model search
Changed onUnified endpoint for discovering model endpoints. Supports three usage modes:
1. List Mode (no parameters): Paginated list of all available model endpoints with minimal metadata.
2. Find Mode (endpoint_id parameter): Retrieve specific model endpoint(s) by ID. Supports single or multiple IDs.
3. Search Mode (search parameters): Filter models by free-text query, category, or status.
Ordering (list/search):
- sort=relevant uses Explore's shared Trending browse order without keywords and relevance order with keywords. Trending data can fall back to publication dates when unavailable.
- sort=recent sorts the complete filtered set by publication date (creation date when the publication date is missing), before pagination.
- An explicit sort is acknowledged by ordering.sort. Omitting sort preserves the default response. Find mode always preserves the supplied endpoint ID order and has no ordering acknowledgement.
- Keep sort, filters and limit unchanged when following next_cursor; cursors are page positions, not snapshots, and catalog/ranking updates can change later pages.
Expansion: Use expand to include additional data in each model object:
- openapi-3.0 — full OpenAPI 3.1 schema in the openapi field (the value keeps its original name)
- enterprise_status — enterprise readiness status (ready or pending) in the enterprise_status field
Examples of endpoint_id values:
- fal-ai/flux/dev
- fal-ai/wan/v2.2-a14b/text-to-video
- fal-ai/minimax/video-01/image-to-video
- fal-ai/hunyuan3d-v21
See fal.ai Model APIs for more details.
Authentication: Optional. Providing an API key grants higher rate limits.
Common Use Cases:
- Browse available models for integration
- Retrieve metadata for specific endpoints
- Search for models by category or keywords
- Get OpenAPI schemas for code generation
- Build model selection interfaces
Authentication: not required.
Request
- Base URLhttps://api.fal.ai/v1
- URLhttps://api.fal.ai/v1/models
- Auth
- none
- or API key in header Authorization
Query parameters
Maximum number of items to return. Actual maximum depends on query type and expansion parameters.
Pagination cursor from previous response. Encodes the page number.
Free-text search query to filter models by name, description, or category
Filter by category (e.g., 'text-to-image', 'image-to-video', 'training')
Filter models by status - omit to include all statuses
List/search ordering: relevant uses Explore's shared Trending browse order or keyword relevance; recent sorts by publication date (creation date when the publication date is missing). Defaults to relevant. Ignored in endpoint_id find mode, which preserves input order. Keep sort, filters and limit unchanged when following a cursor.
Response
Successfully retrieved model endpoints
Changes
- info
added the new optional
queryrequest parametersort - info
added the optional property
to the response with the status
- info