Models

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.

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.

get/models

Request

  • Base URL
    https://api.fal.ai/v1
  • URL
    https://api.fal.ai/v1/models
  • Auth
    • none
    • or API key in header Authorization

Query parameters

limitinteger

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

Example:50
cursorstring

Pagination cursor from previous response. Encodes the page number.

Example:Mg==
string
OR
string[]
qstring

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

Example:text to image
categorystring

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

Example:text-to-image
status'active' | 'deprecated'

Filter models by status - omit to include all statuses

Example:active
sort'relevant' | 'recent'

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.

Example:recent
string
OR
string[]

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

    • info

      added the new optional query request parameter sort

    • info

      added the optional property to the response with the status