FAfal
Models

Published model insights and weekly statistics (beta)

Changed on

Experimental (beta): model guidance and evidence may change as we refine recommendations. Find model guidance by task or endpoint. Only current public models visible to the caller are returned. Version 3 evidence includes p50/p90 in milliseconds, analytics category trending rank and registry publication dates. Statistics are optional, dated observations, not prices or quality benchmarks. Use get_pricing for current prices with their units and required configuration.

Required permissions: none. Any authenticated caller can use this API.

get/models/insights

Request

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

Query parameters

string
OR
string[]
qstring

Task description used to search published model guidance; provide q or endpoint_id.

Example:Product photography with clear lettering
limitinteger

Maximum number of account-visible models to return.

Example:5

Response

Model insights

unavailable_endpoint_idsstring[] required

Explicitly requested endpoint IDs that are not public or accessible to this caller.

stats_availableboolean required

Whether a valid snapshot for the last completed week was available; individual model evidence may still be unknown.

notestring required

Guidance on interpreting observations, trending, adoption, newness and recommendations.

Changes