文档中心

对象存储

请输入

媒体处理

VideoUnderstanding

功能描述

此接口用于对视频内容进行理解，包括内容变化、动作逻辑、时序关联等。支持指定方舟 VLM 模型、自定义提示词及采样帧率（FPS），并返回模型的解析结果。视频传输支持 Presign URL 和 Base64 编码两种模式，具体生效模式由服务端配置决定。

注意事项

请求消息样式

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
x-tos-process	Query	String	是	video/understanding	代表视频理解请求的特殊标识。
Host	Header	string	是	my-bucket.tos-cn-beijing.volces.com	请求的主机地址，格式为 <bucket>.tos-<region>.volces.com
x-tos-bucket	Header	string	否	my-bucket	Bucket名称，由 TOS 网关从 URL 解析后自动注入，调用方无需手动设置。
x-tos-bucket-owner-id	Header	string	否	10000001	Bucket 所所有者ID，由 TOS 网关自动注入，用于账号白名单校验，调用方无需手动设置。
x-source-object-info	Header	string	否	-	对象元信息，由 TOS 网关自动注入，调用方无需手动设置。

请求元素

名称	参数类型	是否必选	示例值	说明
m	String	否	ZG91YmFvLXNlZWQtMS42LXZpc2lvbg==	方舟模型名（base64 url 编码），取值：doubao-seed-1.6-vision。
p	String	是	6K-l6KeG6aKR55qE5Li76KaB5YaF5a655piv5LuA5LmI	提示词（base64 url 编码），原文长度不超过 1024 字节。
fps	Float	否	0.5	视频采样帧率，作为时序帧信息输入视频理解，用于控制视频理解精细度。取值范围： [0.2, 5]，默认值： 1.0。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

名称	位置	类型	是否必选	示例值	说明
Content-Type	Header	string	是	application/json	响应体的 MIME 类型，值为 application/json，表示响应为 JSON 格式。
x-tos-data-process	Header	string	是	video	数据处理类型标识，值为 video。
Content-Length	Header	string	是	512	响应体的字节长度。

响应元素

请求示例

响应示例

最近更新时间：2026.05.25 16:50:48

这个页面对您有帮助吗？

有用

无用