Gemini Video Vision 视频理解: AI 大语言模型

如何使用 Gemini Video Vision

1. 提供视频 URL：将视频托管在公开可访问的 URL（例如 S3 或 CDN 链接）上，并将其作为 video_url 传入。

2. 编写提示词：描述希望分析的内容——一般性描述、结构化 JSON 拆解，或关于视频内容的具体问题。

3. 可选地设置系统提示词：使用 system_prompt 控制输出格式，例如“仅返回结构化 JSON，不要 prose”。

4. 选择模型：gemini-2.5-flash（默认）速度快且成本低；gemini-2.5-pro 能为复杂视频提供更深入、更准确的分析。

5. 提交并轮询：与所有 Muapi 端点一样，提交请求并轮询 /predictions/{request_id}/result，直到 status 为 completed。

Python：

import requests, time

API_KEY = "your_api_key_here"
headers = {"x-api-key": API_KEY, "Content-Type": "application/json"}

r = requests.post("https://api.muapi.ai/api/v1/gemini-video-vision", headers=headers,
    json={
        "prompt": "Describe the camera movement, subjects, and lighting in this video.",
        "video_url": "https://example.com/my-video.mp4"
    })
request_id = r.json()["request_id"]

while True:
    result = requests.get(f"https://api.muapi.ai/api/v1/predictions/{request_id}/result", headers=headers).json()
    if result["status"] == "completed":
        print(result["output"]["text"])
        break
    time.sleep(3)

cURL：

curl -X POST https://api.muapi.ai/api/v1/gemini-video-vision \
  -H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"prompt": "Describe this video in detail.", "video_url": "https://example.com/my-video.mp4"}'

较大的视频处理时间更长，因为 Gemini 需要上传并摄取完整文件——根据视频时长，预计响应时间从几秒到几分钟不等。