# Video & Image AI: Transcripts, Scenes, Objects, Insights (`ntriqpro/video-intelligence-analyzer`) Actor

AI-powered video and image analyzer. Extract transcripts, detect scenes, objects, faces, text, and visual events. Built for content creators, marketers, media teams. Process YouTube URLs, MP4 files, and image batches. Get structured JSON with scene timestamps, object tags, and searchable metadata.

- **URL**: https://apify.com/ntriqpro/video-intelligence-analyzer.md
- **Developed by:** [daehwan kim](https://apify.com/ntriqpro) (community)
- **Categories:** Videos, AI, Automation
- **Stats:** 78 total users, 10 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $50.00 / 1,000 video/image ai analyses

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Video & Image Intelligence Analyzer

AI-powered multimodal analysis for images and videos. Extract structured tags, scene descriptions, text content, mood analysis, and virality scores from any image or video URL.

### Features

- **Image Analysis**: Detailed descriptions of any image
- **Video Analysis**: Frame-by-frame analysis with comprehensive summary
- **Smart Tagging**: Structured JSON output with category, tags, mood, text detection, and virality score
- **15 Languages**: English, Spanish, Portuguese, French, German, Arabic, Hindi, Vietnamese, Thai, Indonesian, Turkish, Russian, Korean, Japanese, Chinese
- **Custom Prompts**: Override default analysis with your own questions

### Pricing

Free plan: each run returns up to 25 results (the first 3 inputs). Paid Apify plans receive the full result set.

**$0.02 per analysis** (pay-per-event). You only pay for successful analyses. Failed analyses are not charged.

### Input

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `urls` | string\[] | *required* | Image or video URLs to analyze |
| `mode` | string | `tag` | `tag` = JSON tags, `image` = description, `video` = frame-by-frame |
| `prompt` | string | — | Custom analysis prompt |
| `language` | string | `en` | Response language (15 supported) |
| `maxFrames` | number | 20 | Max frames for video analysis |
| `maxTokens` | number | 256 | Max response length |

### Output Example (Tag Mode)

```json
{
    "url": "https://example.com/image.jpg",
    "mode": "tag",
    "analysis": {
        "category": "logo",
        "tags": ["google", "search", "technology", "brand", "icon"],
        "mood": "neutral",
        "has_text": true,
        "text_content": "Google",
        "virality_score": 9
    },
    "processingTimeMs": 978,
    "model": "qwen2.5vl:7b"
}
```

### Supported Video Formats

MP4, MOV, AVI, WebM, MKV

### Disclaimer

- Analysis results are generated by AI and provided for reference only. No guarantees of accuracy.
- This tool does not store or redistribute any analyzed content. All temporary files are deleted immediately after processing.
- Users are responsible for ensuring they have the right to analyze the content they submit.
- This tool is not intended for surveillance, facial recognition databases, or any use prohibited by applicable laws.
- The developer is not liable for any decisions made based on the analysis results.
- By using this Actor, you agree that analysis of content containing personal data (faces, identifying information) is your responsibility under applicable privacy laws including GDPR.

***

### 🔗 Related Actors by ntriqpro

Build your data pipeline with the ntriqpro Actor suite:

- [**alt-text-batch**](https://apify.com/ntriqpro/alt-text-batch) — Bulk Alt-Text Generator — SEO + WCAG
- [**content-factory**](https://apify.com/ntriqpro/content-factory) — AI Content Engine — Quiz, Flashcard, Podcast
- [**image-batch-optimizer**](https://apify.com/ntriqpro/image-batch-optimizer) — Image Compressor

### ⭐ Love it? Leave a Review

Your rating helps creators and media teams discover this actor. [Rate it here](https://apify.com/ntriqpro/video-intelligence-analyzer/reviews).

# Actor input Schema

## `urls` (type: `array`):

Image or video URLs to analyze. Free plan: each run returns up to 25 results (the first 3 inputs). Paid Apify plans receive the full result set.

## `mode` (type: `string`):

tag = structured JSON tags, image = free-form description, video = frame-by-frame analysis

## `prompt` (type: `string`):

Optional custom analysis prompt (overrides default)

## `language` (type: `string`):

Response language

## `maxFrames` (type: `integer`):

Maximum frames to extract from video

## `maxTokens` (type: `integer`):

Maximum response length per analysis

## Actor input object example

```json
{
  "urls": [
    "https://upload.wikimedia.org/wikipedia/commons/thumb/4/47/PNG_transparency_demonstration_1.png/280px-PNG_transparency_demonstration_1.png"
  ],
  "mode": "tag",
  "language": "en",
  "maxFrames": 20,
  "maxTokens": 256
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://upload.wikimedia.org/wikipedia/commons/thumb/4/47/PNG_transparency_demonstration_1.png/280px-PNG_transparency_demonstration_1.png"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("ntriqpro/video-intelligence-analyzer").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "urls": ["https://upload.wikimedia.org/wikipedia/commons/thumb/4/47/PNG_transparency_demonstration_1.png/280px-PNG_transparency_demonstration_1.png"] }

# Run the Actor and wait for it to finish
run = client.actor("ntriqpro/video-intelligence-analyzer").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    "https://upload.wikimedia.org/wikipedia/commons/thumb/4/47/PNG_transparency_demonstration_1.png/280px-PNG_transparency_demonstration_1.png"
  ]
}' |
apify call ntriqpro/video-intelligence-analyzer --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,ntriqpro/video-intelligence-analyzer"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/dI2dd9GZFYetLgRzQ/builds/wEGz9ye4lCXuF41jn/openapi.json