Skip to main content
GET
https://api.unify.ai
/
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