---
title: KeyFrameAnalysisRequest
framework: Media Intelligence
role: symbol
role_heading: Class
platforms: [iOS 27.0+, iPadOS 27.0+, Mac Catalyst 27.0+, macOS 27.0+, tvOS 27.0+, visionOS 27.0+]
path: mediaintelligence/keyframeanalysisrequest
---

# KeyFrameAnalysisRequest

A request that identifies the best representative frame of a video.

## Declaration

```swift
final class KeyFrameAnalysisRequest
```

## Mentioned in

Finding the best moments in a video

## Overview

Overview Use this type to find the single frame that best represents the overall content of the video. Pass it to analyze(_:for:) to receive a KeyFrameAnalysisRequest.Result value containing the frame’s timestamp. Use the timestamp to seek a player to that position or to extract a thumbnail image.

## Topics

### Creating a request

- [init()](mediaintelligence/keyframeanalysisrequest/init().md)

### Inspecting the result

- [KeyFrameAnalysisRequest.Result](mediaintelligence/keyframeanalysisrequest/result.md)

## Relationships

### Conforms To

- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)
- [VideoAnalyzer.Request](mediaintelligence/videoanalyzer/request.md)

## See Also

### Video analysis

- [Finding the best moments in a video](mediaintelligence/finding-the-best-moments-in-a-video.md)
- [VideoAnalyzer](mediaintelligence/videoanalyzer.md)
- [MediaIntelligenceVideoAsset](mediaintelligence/mediaintelligencevideoasset.md)
- [HighlightAnalysisRequest](mediaintelligence/highlightanalysisrequest.md)