---
title: "Describe video frame"
method: POST
path: "/video/{video_id}/frame/{frame_id}/describe/"
---

# Describe video frame

`POST /video/{video_id}/frame/{frame_id}/describe/`

## Request

- Base URL: `https://api.videodb.io`
- URL: `https://api.videodb.io/video/{video_id}/frame/{frame_id}/describe/`
- Auth: API key in header `x-access-token`
- TypeScript: <https://skmtc.dev/video-db/apis/videodb-server-api/docs/video/:video_id/frame/:frame_id/describe/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `video_id` string, required
- `frame_id` string, required

## Request body

- object
  - `prompt` string
  - `model_name` string

## Response `200`

Frame description generated

- object
  - `success` boolean
  - `data` object
    - `description` string

---

[API](https://skmtc.dev/video-db/apis/videodb-server-api.md) - [All operations](https://skmtc.dev/video-db/apis/videodb-server-api/llms.txt) - [OpenAPI document](https://skmtc.dev/video-db/apis/videodb-server-api/revisions/21b1d1d3eae8?raw)