GET
/
v0
/
logs
/
metric
/
{default_metric}
curl --request GET \
  --url 'https://api.unify.ai/v0/logs/metric/<default_metric>?project=None' \
  --header "Authorization: Bearer $UNIFY_KEY"
  --header 'Content-Type: application/json' \
  --data '{}'
4.56

Returns the reduction metric for filtered values (base + derived) for one or more keys from a project.

This endpoint supports three modes of operation:

  1. Single key, no grouping: Returns a single metric value Example:

    GET /logs/metric/mean?key=score

    Response:

    4.56

  2. Multiple keys, no grouping: Returns a dict mapping keys to metric values Example:

    GET /logs/metric/mean?key=["score","length"]

    Response:

    {"score": 4.56, "length": 120}

  3. With grouping: Returns metrics grouped by one or more fields Example:

    GET /logs/metric/mean with body {"key": "score", "group_by": "model"}

    Response:

    {"gpt-4": 4.56, "gpt-3.5": 3.78}

    For nested grouping, provide a list of fields: Example:

    GET /logs/metric/mean with body {"key": "score", "group_by": ["model", "temperature"]}

    Response:

    {"gpt-4": {"0.7": 4.56, "0.9": 4.23}, "gpt-3.5": {"0.7": 3.78, "0.9": 3.45}}

The group_by parameter can be a string for single-level grouping or a list of strings for nested grouping. Each group_by field can be prefixed with “params/” to indicate it’s a parameter.

​
Authorizations

​
Authorization
string
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

​
Path Parameters

​
default_metric
string
required

​
Query Parameters

​
project
string
required

​
Body

​
key
string | array | null

Single key string or a list of keys.

​
metrics
object | null

Optional per-key metrics mapping. If provided, overrides the path metric for those keys.

​
filter_expr
string | object | null

Expression to filter logs (string or key->expr dict).

​
from_ids
string | object | null

Log IDs to include (string or key->IDs dict).

​
exclude_ids
string | object | null

Log IDs to exclude (string or key->IDs dict).

​
context
string | null

Context name (string).

​
group_by
string | array | null

Field(s) to group by when computing metrics. Can be a single field name or a list of field names for nested grouping.

curl --request GET \
  --url 'https://api.unify.ai/v0/logs/metric/<default_metric>?project=None' \
  --header "Authorization: Bearer $UNIFY_KEY"
  --header 'Content-Type: application/json' \
  --data '{}'
4.56