Analyze uploaded video file

POST

/api/v1/analyze/file

Analyze a video file uploaded directly to the API.

Supported formats: MP4, AVI, MOV, MKV, WEBM
Max file size: 50MB

Credit costs:

Base analysis: 1 credit

Cinematography: 2 credits

IAB categories: 1 credit

Topics: 1 credit

Description: 3 credits

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Header Params

Body Params multipart/form-dataRequired

Responses

🟢200OK

application/json

Successful response

Body

🟠401Unauthorized

🟠402402

🟠422Parameter Error

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://vid-tag-api.framealyzer.com/api/v1/analyze/file' \
--header 'Authorization: <api-key>' \
--form 'file=@""' \
--form 'analyses=""'

Response Example

200 - Success

{
    "success": true,
    "results": {
        "cinematography_tags": [
            "Wide Shot",
            "Soft Lighting",
            "Slow Motion"
        ],
        "iab_tags": [
            "Arts & Entertainment",
            "Video Gaming"
        ]
    },
    "metadata": {
        "file_size": 15728640,
        "filename": "sample_video.mp4",
        "content_type": "video/mp4",
        "processing_method": "file_api",
        "credits_consumed": 4
    }
}

Modified at 2025-08-18 16:21:20

Analyze video from base64 data

Analyze YouTube video