文档中心

AI MediaKit

开始使用

快速入门：视频理解前处理

AI MediaKit 的视频理解工具，基于火山方舟视觉大模型，专为大文件视频（URL 传入方式的视频上限从 50 MB 放宽至 5 GB）的内容解析而设计。通过 Chat API，您可以像对话一样对视频进行总结、问答、抽帧分析或视觉定位，从而在海量视频数据中快速提取核心价值信息。

本篇快速入门将引导您在几分钟内通过 API 调用视频理解工具。

效果示例

输入	输出
Prompt：总结描述视频的主要内容？ Replay Play 00:00 / 00:05 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag	这是一段AI生成的视频，呈现了黄昏时分伦敦的标志性场景：画面中心是大本钟（伊丽莎白塔），时钟指针快速转动，一旁的桥上车流穿梭不息，其中包含伦敦标志性红色双层巴士，背景是笼罩在暖调暮色里的城市天际线，整体展现出这座城市繁忙的日常与时间的流转感。

准备工作

由于视频理解工具集成了火山方舟的模型推理与 AI MediaKit 的媒体处理能力，在发起请求前，您需要获取以下两类凭证：

1. 获取模型相关信息（火山方舟侧）

说明

模型列表：快速浏览方舟提供的模型全集以及各个模型所具备的能力，快速根据你的实际场景匹配到合适的模型。

2. 获取媒体处理凭证（AI MediaKit 侧）

访问 AI MediaKit 控制台 API Key 管理页面，创建并获取 AI MediaKit API Key（用于视频拉取与预处理鉴权）。

操作步骤

步骤 1：安装 SDK

AI MediaKit 的 Chat API 完全兼容 OpenAI 及火山方舟 Chat API。您可以根据开发习惯选择使用 OpenAI 官方 SDK 或火山方舟 SDK。

说明

提示：如果您只是想快速测试，可以跳过安装 SDK，直接查看步骤 2 中的 curl 示例。

Python

Java

运行环境中需安装 Python 版本 3.7 或以上。

说明

步骤 2：发起视频理解请求

通过一个公网可访问的 URL 将视频传给模型，并配合提示词（Prompt）获取分析结果。

说明

在拷贝并运行下方示例代码前，请确保执行以下操作：

拼接并填入鉴权信息：将火山方舟 API Key 与 MediaKit API Key 用英文斜杠 / 拼接（格式为火山方舟Key/MediaKitKey），填入代码中的 api_key 或 Authorization 占位符处。

Curl

Python

Java

OpenAI SDK

下一步

现在你已经完成了 AI MediaKit 的首次 API 调用，接下来你可以探索模型的更多能力，详见视频理解。

最近更新时间：2026.04.01 14:18:37

这个页面对您有帮助吗？

有用

无用