概述
gemini-3-pro-preview-file 模型支持通过 file_data.file_uri 直接分析任意可访问的视频文件 URL,无需预先上传文件。
[!NOTE]
- 接口:
POST /v1beta/models/gemini-3-pro-preview-file:generateContent- 当前仅支持视频分析,支持 MP4、MOV、AVI、FLV、MKV、WebM 等常见格式
mime_type可选,未提供时会尝试自动推断
基础示例
请求参数
file_data 对象
应用场景
视频内容总结
视频问答
视频时间戳提取
流式输出
注意事项
[!WARNING]
- 仅支持单文件分析,每次请求只能分析一个视频
- 视频 URL 必须是公开可访问的
- 大视频文件可能需要较长处理时间
- 建议视频时长控制在合理范围内以获得最佳分析效果

