Analyze video from base64 data

POST

/api/v1/analyze/inline

Analyze video content provided as base64-encoded data.

This endpoint is suitable for smaller videos that can be sent directly in the request body.
For larger videos (>10MB), consider using the file upload endpoint.

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 application/jsonRequired

Examples

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/inline' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "analyses": [
        "professional_cinematography_tags",
        "topic_tags"
    ],
    "video_data": "base64_encoded_video_data_here"
}'

Response Example

200 - Success

{
    "success": true,
    "results": {
        "cinematography_tags": [
            "Handheld Shot",
            "Natural Lighting"
        ],
        "topics_tags": [
            "Technology",
            "Innovation"
        ]
    },
    "metadata": {
        "file_size": 1048576,
        "processing_method": "inline_data",
        "credits_consumed": 4
    }
}

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

Analyze uploaded video file