Skip to main content

AI Analytics

AI gateway usage analytics, in requests and tokens.

Access it as client.ai.analytics on a Strongly client, or the same path on AsyncStrongly with await. All methods exist on both with identical signatures.

Methods​

All methods​

performance​

performance(*, date_range: DateRange, model_id: str | None = None) -> list[ModelPerformance]

Return each model's latency over a range, most requests first.

Parameters

  • date_range ({"24h", "7d", "30d", "90d"}): The range, ending now.
  • model_id (str | None, optional): Only this model.

Returns

  • list[ModelPerformance]: One row per model with requests in the range.

providers​

providers(*, date_range: DateRange) -> list[ProviderStats]

Return each provider's models, requests, tokens, latency and users over a range.

Parameters

  • date_range ({"24h", "7d", "30d", "90d"}): The range, ending now.

Returns

  • list[ProviderStats]: One row per provider, most requests first.

time_series​

time_series(*, date_range: DateRange, granularity: Granularity, provider: str | None = None) -> list[TimeSeriesPoint]

Return requests, tokens, mean latency and errors per provider per period.

A daily series has every UTC day of the range (a day without requests has zero requests and no latency).

Parameters

  • date_range ({"24h", "7d", "30d", "90d"}): The range, ending now.
  • granularity ({"hourly", "daily"}): The period: hourly only with date_range="24h".
  • provider (str | None, optional): Only this provider's requests.

Returns

  • list[TimeSeriesPoint]: One point per period and provider, in time order.

Raises

  • ValidationError: An hourly series of a range longer than 24 hours.

usage​

usage(*, date_range: DateRange, model_id: str | None = None) -> UsageStats

Return the totals of a range: requests, tokens, latency, errors, users and models.

Parameters

  • date_range ({"24h", "7d", "30d", "90d"}): The range, ending now.
  • model_id (str | None, optional): Only this model's requests.

Returns

  • UsageStats: The range's totals.