返回模型调用 API 参考POST/v1beta/models/gemini-2.5-pro:generateContent
Gemini:URL、搜索与视频输入如何选择
避免把网页读取、网络搜索和视频理解混成一个 URL Context 请求。
按输入选择动作
URL 不等于文件
网页地址可能返回 HTML、重定向或登录页。只有符合对应协议的媒体来源才能作为文件输入。本目录推荐本地文件内联流程,避免使用其他账户的临时 Files URI。
不要对 YouTube 链接简单设置 UrlContext 并认定获得了音视频内容。若需要特定视频平台的 URL 输入,先确认目标模型和媒体入口的限制;通用方案是取得有权使用的短片段后按视频理解页发送。
工具结果校验
检查 URL 抓取状态或搜索引用,再展示答案。生成文字包含某个链接,不足以证明链接被读取或内容已验证。
参考:Google Grounding 指南。
Request
请求
/v1beta/models/gemini-2.5-pro:generateContentBody
必填路径、查询与 Header 参数
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|
key | Query | string | 是 | - | YOUR_API_KEY |
Content-Type | Header | string | 是 | - | application/json |