开发者接入

API、MCP 与 API Key

通过 PromptVV 账户接入视频反推能力。API 与 MCP 共用网页版余额、任务历史和成功后扣费规则，支持视频链接和本地视频文件。

API Key

密钥只在创建时完整显示，请立即复制并妥善保存。

还没有 API Key。

HTTP API

所有请求使用 Authorization: Bearer YOUR_API_KEY。本地文件采用预签名直传，避免经过应用服务器。

分析视频链接

curl -X POST '/api/v1/analyze' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com/video"}'

上传并分析本地视频

# 1. 创建上传地址
curl -X POST '/api/v1/uploads' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"filename":"video.mp4","size_bytes":12345678}'

# 2. PUT 文件到返回的 upload_url
curl -X PUT --upload-file ./video.mp4 'UPLOAD_URL'

# 3. 提交返回的 upload_key
curl -X POST '/api/v1/analyze' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"upload_key":"UPLOAD_KEY","title":"video.mp4"}'

查询结果与余额

GET /api/v1/jobs/JOB_ID
GET /api/v1/credits

MCP

远程 MCP 地址为 /api/mcp。可用工具：get_quota、create_video_upload、analyze_video、get_analysis。

{
  "mcpServers": {
    "promptvv": {
      "url": "/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

本地文件说明：先调用 create_video_upload 获取临时地址，由支持本地文件与 HTTP PUT 的 MCP 客户端上传，再调用 analyze_video。链接可直接交给 analyze_video。