videoseed API 与 MCP

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

{
  "id": "c9aa82c5-79ac-4cb8-9a91-9223dc83b6b8",
  "status": "queued",
  "queued": true
}

# 1. 获取预签名上传地址
curl -X POST 'https://www.videoseed.cc/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 'https://www.videoseed.cc/api/v1/analyze' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"upload_key":"UPLOAD_KEY","title":"video.mp4"}'

{
  "upload_key": "uploads/USER_ID/FILE_ID.mp4",
  "upload_url": "https://storage.example.com/...",
  "method": "PUT",
  "expires_in": 1800,
  "max_bytes": 1073741824
}

curl 'https://www.videoseed.cc/api/v1/credits' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "balanceSec": 1800,
  "isPro": true,
  "activePacks": 1
}

curl 'https://www.videoseed.cc/api/v1/jobs/JOB_ID' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "id": "c9aa82c5-79ac-4cb8-9a91-9223dc83b6b8",
  "status": "done",
  "source_kind": "link",
  "title": "示例视频",
  "result": { "text": "完整的视频分析与提示词结果" },
  "error_code": null,
  "charged_seconds": 15,
  "created_at": "2026-07-29T08:00:00.000Z",
  "updated_at": "2026-07-29T08:02:10.000Z"
}

{
  "id": "c9aa82c5-79ac-4cb8-9a91-9223dc83b6b8",
  "status": "error",
  "source_kind": "file",
  "title": "video.mp4",
  "result": null,
  "error_code": "ASR_FAILED",
  "charged_seconds": null,
  "created_at": "2026-07-29T08:00:00.000Z",
  "updated_at": "2026-07-29T08:01:20.000Z"
}

curl 'https://www.videoseed.cc/api/v1/jobs/JOB_ID/video-link?mode=play' \
  -H 'Authorization: Bearer YOUR_API_KEY'

curl 'https://www.videoseed.cc/api/v1/jobs/JOB_ID/video-link?mode=download' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "url": "https://r2.videoseed.cc/upload/<sha>/video/source.mp4",
  "mode": "play",
  "expires_in": 1800,
  "expires_at": "2026-08-10T00:30:00.000Z",
  "content_type": "video/mp4",
  "filename": "示例视频.mp4"
}

GET https://www.videoseed.cc/api/v1/jobs?limit=20&status=done
Authorization: Bearer YOUR_API_KEY

响应：items / has_more / next_cursor

POST https://www.videoseed.cc/api/v1/analyses/batch
Idempotency-Key: batch-20260805-01
body: { items: [{ client_reference_id, upload_key | url, title, dims }] }

一次最多 8 项。相同 Idempotency-Key 与请求内容会重放第一次响应；内容不同返回 409 IDEMPOTENCY_CONFLICT。

GET /api/v1/capabilities（含 video_links：play 1800 秒、download 600 秒）
GET /api/v1/usage?limit=20
POST /api/v1/jobs/{id}/retry
POST /api/v1/jobs/{id}/cancel

usage 是追加式账本：analysis_charge 为负，credit_purchase / reservation_release 为正。只有 error 可重试，只有 queued / analyzing 可取消。

需要 scope webhooks:manage。

POST /api/v1/webhooks
{ "url": "https://your-server.example/hook", "events": ["analysis.completed", "analysis.failed"] }
→ 201，secret 只回一次（whsec_…）

GET /api/v1/webhooks → 列表（不含 secret）
DELETE /api/v1/webhooks/{id} → { "ok": true }

URL 必须 HTTPS 公网；localhost、私网、链路本地、云元数据地址会被拒（400 WEBHOOK_INVALID_URL）。
投递器不跟随重定向。

请求头：X-Videoseed-Event-Id、X-Videoseed-Delivery-Id、X-Videoseed-Timestamp、X-Videoseed-Signature
签名：sha256=HMAC_SHA256(secret, timestamp + "." + rawBody)
非 2xx / 超时按指数退避重试，最多 8 次后置 failed。

// 接收端：先验签再 JSON.parse；拒绝 >5 分钟的时间戳；按 event_id 去重
const ts = req.headers['x-videoseed-timestamp'];
const sig = req.headers['x-videoseed-signature'];
const raw = await readRawBody(req);
if (!verifyHmac(secret, ts, raw, sig)) return res.status(401).end();
const payload = JSON.parse(raw);

curl -X POST 'https://www.videoseed.cc/api/mcp' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0",
    "id":1,
    "method":"tools/call",
    "params":{"name":"get_quota","arguments":{}}
  }'

{
  "code": "QUOTA_INSUFFICIENT",
  "message": "额度不足，请充值",
  "request_id": "82d64113-09b0-473b-a7b5-1f11bbb08f64"
}