Get shot scores for a video | Coactive AI

curl -G https://api.coactive.ai/api/v0/video-scores/groups/group_id/tags/tag_id/versions/version_id/videos/video_id/shot-scores \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d dataset_id=dataset_id

{
  "data": [
    {
      "shot_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "score": 0.87,
      "start_time": 12.5,
      "end_time": 18.3,
      "duration": 5.8,
      "textPrompts": [
        {
          "modality": "Visual",
          "prompt": "A person riding a mountain bike on a trail"
        }
      ]
    },
    {
      "shot_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "score": 0.92,
      "start_time": 18.4,
      "end_time": 25,
      "duration": 6.6,
      "textPrompts": [
        {
          "modality": "Transcript",
          "prompt": "The cyclist speeds down the hill"
        }
      ]
    }
  ],
  "total_shot_count": 2
}

Retrieve shot-level scores for a given video and tag version: score, start/end time, and duration for each shot (only shots with score >= min_conf).

Authentication

AuthorizationBearer

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

Path parameters

group_idstringRequiredformat: "uuid"

The ID of the Dynamic Tag group.

tag_idstringRequiredformat: "uuid"

The ID of the tag within the group.

version_idstringRequiredformat: "uuid"

The tag version ID.

video_idstringRequiredformat: "uuid"

The Coactive Video ID to retrieve shot scores for.

Query parameters

dataset_idstringRequiredformat: "uuid"

Dataset ID (used to locate the shot scores table).

min_confdoubleOptional<=1Defaults to 0.5

Minimum confidence threshold (score >= min_conf). Must be greater than 0.1.

Response

Successful Response

datalist of objects

Shot scores for the video.

total_shot_countinteger or null

Total number of shots in the video (from Pinot composite keyframes); null if unavailable.

Errors

404

Not Found Error

422

Unprocessable Entity Error