fal.ai icon

fal.ai

Generate AI content using fal.ai models and workflows

Actions10

Model → Get Analytics

AI-generated

Summary

Retrieve performance analytics for a specified fal.ai model over a chosen time range, including metrics such as request counts, success rates, error counts, and duration statistics.

Inputs

  • Model (required) — Select the fal.ai model (endpoint) to retrieve analytics for, either from a searchable list or by specifying its ID.
  • Time Range (required) — Choose the time range over which to gather analytics data. Options include predefined intervals (e.g., last 1 hour, last 7 days) or a custom date/time range where start and end dates must be specified.
  • Start Date — Specify the start date/time for a custom time range in ISO8601 format (shown only if 'Custom Range' is selected).
  • End Date — Specify the end date/time for a custom time range in ISO8601 format (shown only if 'Custom Range' is selected).
  • Options — Configure additional analytics options such as which metrics to include (e.g., request count, error count, duration percentiles), which data to expand (time series data, summary statistics), the timeframe aggregation for time series, and a limit on the number of results returned.

Output shape

a single JSON object containing analytics data fields like endpoint ID, time range used, and requested metrics potentially including time series data and summaries.

The response includes the requested metrics and data expansions as specified by the input options. Time range defaults to last 24 hours if not custom. The aggregation timeframe is auto-detected unless explicitly set. The maximum number of data points can be limited up to 1000. Errors from the fal.ai API are surfaced as node errors.

Links

Discussion