视频分析 API

功能介绍

传入一个短视频链接，拿回一份深度的中英双语解读，帮你看懂这支视频为什么吸引人、好在哪里，供你自己创作时参考。

• 支持的平台：公开的 Facebook、Instagram、TikTok 视频，最长 3 分钟。暂时不支持 YouTube 链接。
• Instagram 主页：发一个用户名，我们会看这个主页最新发布的公开视频 —— 一次最多 5 支 —— 逐支分析。
• 用起来是这样的：提交一个任务，马上拿到任务号，然后查这个任务，直到结果出来。

快速开始

1. 要一个账号。账号由我们开 —— 发邮件到 support@elitepropai.com。你会拿到用户名和一个初始密码。新账号送 30 分 API 积分。
2. 登录控制台 https://api.elitepropai.com，先改密码。
3. 建一把 API key（在「API key」那一栏）。完整的 key 只显示一次 —— 存在你的服务器上，比如放进环境变量。不要放进网页或手机 App。
4. 第一次调用：

curl -X POST https://api.elitepropai.com/v1/video-insights/analyze \
  -H "Authorization: Bearer $PROPAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.instagram.com/reel/C0dExAmPlE1/"}'

马上会拿回一个任务：

{
  "id": "job_4fQ2mZ8kT1pLx0aB7cRd",
  "object": "job",
  "type": "video",
  "status": "queued",
  "credits": { "charged": 1, "refunded": 0 },
  ...
}

5. 查结果。每 10–15 秒查一次，直到 status 变成 done 或 failed。单支视频一般 2–5 分钟。

curl https://api.elitepropai.com/v1/jobs/job_4fQ2mZ8kT1pLx0aB7cRd \
  -H "Authorization: Bearer $PROPAI_API_KEY"

不想敲命令？控制台里有个「试一试」面板，在你的账号上跑同样的分析，任务的变化实时显示出来。

认证方式

• 每个请求都要在请求头里带上 key：Authorization: Bearer <你的 API key>。
• key 以 pai_ 开头。每个账号最多 5 把能用的 key，任何一把都可以在控制台里停用 —— 停用后立刻失效。
• 这个 API 只给服务器对服务器调用。浏览器没法直接调（跨域请求一律拒绝），所以 key 放在你的服务器上，不要放进网页或 App。
• 没带 key、key 不对、key 已停用：返回 401 unauthorized。
• 请用 HTTPS：https://api.elitepropai.com。

接口

地址：https://api.elitepropai.com。请求和返回都是 JSON。

分析一支视频。扣 1 分。

返回：202 Accepted 和这个任务。

{
  "id": "job_4fQ2mZ8kT1pLx0aB7cRd",
  "object": "job",
  "type": "video",
  "status": "queued",
  "created_at": "2026-09-23T14:05:12.000Z",
  "finished_at": null,
  "expires_at": "2026-09-30T14:05:12.000Z",
  "credits": { "charged": 1, "refunded": 0 },
  "input": { "url": "https://www.instagram.com/reel/C0dExAmPlE1/" },
  "result": null,
  "error": null
}

上一个任务还在 queued 或 processing 时，同一个链接再发一次，会直接返回原来那个任务（带 "duplicate": true，状态码 200），不会再扣分。

分析一个 Instagram 主页最新发布的公开视频 —— 一次最多 5 支。置顶、图片帖和超过 3 分钟的视频会跳过。

curl -X POST https://api.elitepropai.com/v1/video-insights/profile \
  -H "Authorization: Bearer $PROPAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"profile": "@your_brand"}'

返回：202 Accepted 和这个任务（"type": "profile"）。提交时先扣 5 分，所以余额至少要 5 分；知道这个主页有几支视频之后，用不完的部分马上自动退回 —— 比如只找到 2 支，就退 3 分。

查一个任务的状态；完成了就带上结果。只能查自己账号的任务。

完成的单支任务：

{
  "id": "job_4fQ2mZ8kT1pLx0aB7cRd",
  "object": "job",
  "type": "video",
  "status": "done",
  "created_at": "2026-09-23T14:05:12.000Z",
  "finished_at": "2026-09-23T14:08:34.000Z",
  "expires_at": "2026-09-30T14:05:12.000Z",
  "credits": { "charged": 1, "refunded": 0 },
  "input": { "url": "https://www.instagram.com/reel/C0dExAmPlE1/" },
  "result": {
    "analysis": "<中英双语的深度解读，Markdown 格式>"
  },
  "error": null
}

result.analysis 是一份带格式的中英双语文本（Markdown），用任何 Markdown 渲染器都能直接显示。

完成的主页任务（其中一支没处理成）：

{
  "id": "job_9Hc1sQ7vW3nYk5eT2bLa",
  "object": "job",
  "type": "profile",
  "status": "done",
  "created_at": "2026-09-23T14:10:03.000Z",
  "finished_at": "2026-09-23T14:27:41.000Z",
  "expires_at": "2026-09-30T14:10:03.000Z",
  "credits": { "charged": 5, "refunded": 1 },
  "input": { "profile": "your_brand" },
  "result": {
    "profile": "your_brand",
    "videos_found": 5,
    "skipped": { "pinned": 1, "photos": 3, "too_long": 0 },
    "videos": [
      {
        "index": 1,
        "status": "done",
        "post_url": "https://www.instagram.com/p/C0dExAmPlE1/",
        "posted_at": "2026-09-22T10:00:00.000Z",
        "caption": "Sunset villa walkthrough 🌅 3 rooms, 2 balconies",
        "analysis": "<中英双语的深度解读，Markdown 格式>"
      },
      {
        "index": 2,
        "status": "failed",
        "post_url": "https://www.instagram.com/p/C0dExAmPlE2/",
        "posted_at": "2026-09-20T09:30:00.000Z",
        "caption": "Before / after: empty unit → staged living room",
        "error": { "code": "unavailable", "message": "This video could not be processed right now. Its credit has been returned." },
        "credits_refunded": 1
      }
    ]
  },
  "error": null
}

主页任务跑的过程中，找到的视频会马上出现在 result.videos 里，每支有自己的 status。caption 是帖子文案的前 100 个字。（上面的例子只列了 5 支里的 2 支。）

查余额和每小时的限额。

{
  "object": "account",
  "username": "user1",
  "credits": 27,
  "limits": { "video_per_hour": 30, "profile_per_hour": 6 }
}

任务状态

主页任务里，result.videos 的每一支也有自己的状态。只要有一支分析成功，整个任务就是 done，失败的那几支各自退分；一支都没成的话，任务是 failed，积分全部退回。

每 10–15 秒查一次就行 —— 主页任务每 30 秒查一次就够。结果保留 7 天（看 expires_at），之后再查会返回 404 not_found。

错误码

出错时统一是这个样子：

{ "error": { "code": "insufficient_credits", "message": "Not enough API credits for this request." } }

failed 的任务（或主页任务里失败的某一支），error 里是下面其中一个：

• unavailable —— 现在处理不了，请稍后再试。
• too_long —— 视频超过 3 分钟。
• not_found —— 视频或主页是私密的、已删除或不存在，或者这个主页最近没有公开视频。

积分和价钱

• 失败的一律自动退回 —— 不管是某一支失败，还是整个任务失败。
• 上一个任务还没跑完时，同一个链接或主页再发一次，会返回原来那个任务 —— 不会重复扣分。
• 新账号送 30 分。用 GET /v1/account 或在控制台看余额；每次扣分和退分都列在控制台的「调用记录」里。
• 价钱以后可能调整，调整前会先通知你。

怎么充值

发邮件到 support@elitepropai.com，写上你的用户名和要充多少积分。充值后在控制台的「充值记录」里看得到。

限制

• 只支持公开视频，最长 3 分钟。
• Instagram 主页：一次最多看最新的 5 支公开视频；置顶、图片帖和超过 3 分钟的跳过。
• 每把 key 每小时：单支 30 次、主页 6 次。主页分析另外还有一个所有用户共用的每小时上限 —— 到了会返回 rate_limited，retry_after 大约 10 分钟。
• 每个账号最多 5 把能用的 key。
• 请求体最大 16 KB。
• 结果保留 7 天。