Sign in
Models

Model search

Unified 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.

Expansion: Use expand to include additional data in each model object:

  • openapi-3.0 — full OpenAPI 3.0 schema in the openapi field
  • 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
get/models

Query parameters

limitinteger

Maximum number of items to return. Actual maximum depends on query type and expansion parameters.

Example:50

Maximum number of items to return. Actual maximum depends on query type and expansion parameters.

cursorstring

Pagination cursor from previous response. Encodes the page number.

Example:Mg==

Pagination cursor from previous response. Encodes the page number.

string
OR
string[]

Endpoint ID(s) to retrieve (e.g., 'fal-ai/flux/dev'). Can be a single value or multiple values (1-50 models). When combined with search params, narrows results to these IDs. Use array syntax: ?endpoint_id=model1&endpoint_id=model2

qstring

Free-text search query to filter models by name, description, or category

Example:text to image

Free-text search query to filter models by name, description, or category

categorystring

Filter by category (e.g., 'text-to-image', 'image-to-video', 'training')

Example:text-to-image

Filter by category (e.g., 'text-to-image', 'image-to-video', 'training')

status'active' | 'deprecated'

Filter models by status - omit to include all statuses

Example:active

Filter models by status - omit to include all statuses

string
OR
string[]

Fields to expand in the response. Supported values: 'openapi-3.0' (includes full OpenAPI 3.0 schema in 'openapi' field), 'enterprise_status' (includes enterprise readiness status)

Response

Successfully retrieved model endpoints

next_cursorstring nullable

Cursor for the next page of results, null if no more pages

has_moreboolean required

Boolean indicating if more results are available (convenience field derived from next_cursor)

Changes

No recorded changes to this endpoint across all 2 revisions of this API.