---
title: "Face tracks of the clip"
method: GET
path: "/api/clips/{id}/faces"
tags: ["smart"]
---

# Face tracks of the clip

`GET /api/clips/{id}/faces`

## Request

- Base URL: `https://cliponit.app`
- URL: `https://cliponit.app/api/clips/{id}/faces`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `session`
  - OAuth 2 (authorization code, authorization URL `https://cliponit.app/oauth/authorize`, token URL `https://cliponit.app/oauth/token`, scopes: `clips`)

Boxes as `[t, x, y, w, h]` (t relative to the clip, x/y/w/h fractions 0..1 of the source); `activity` as `[t, v]` (mouth-motion variance, higher = speaking).

## Path parameters

- `id` string, uuid, required

## Response `200`

Tracks

- FaceTrack[]
  - `id` integer, required
  - `boxes` array[], required: [t, x, y, w, h]
    - number[]
  - `activity` array[], required: [t, mouth-motion variance]
    - number[]

## Other responses

- `404`: Resource not found or not owned by the user

---

[API](https://skmtc.dev/cliponit/apis/cliponit-api.md) · [All operations](https://skmtc.dev/cliponit/apis/cliponit-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cliponit/apis/cliponit-api/revisions/10e3e4327922?raw)