影片分析技能

技能說明

這個技能幫助使用者分析影片檔案，自動提取實體、生成關係圖譜和角色檔案。

功能：將影片內容（劇集、電影等）轉換為結構化的分析結果。

使用方法

注意：以下示例使用 curl 展示請求格式，實際由 OpenClaw 工具呼叫執行，無需手動執行命令。

第一步：首次使用配置

使用本技能前，需要配置智靈平臺的 App-Key。

步驟 1：註冊智靈賬號

• 訪問 https://skills.zeelin.cn
• 點選註冊，完成賬號建立

步驟 2：建立應用

• 登入後進入控制台 → 應用管理
• 點選"建立應用"，填寫應用名稱
• 複製生成的 App-Key

步驟 3：配置到技能

• 開啟本 Skill 的配置檔案：templates/config.json
• 將複製的 App-Key 貼上到 Zeelin_App_Key 欄位
• 儲存檔案，重新觸發本技能即可使用

配置示例：

{
  "Zeelin_App_Key": "xxxxxxxxxxxxxxxxxxx",
  "Zeelin_Api_Url": "https://skills.zeelin.cn",
  "Zeelin_Website_Url": "https://skills.zeelin.cn"
}

第二步：上傳影片檔案到 OSS

介面: POST {service_url}/api/skill/upload

請求格式: multipart/form-data (不是 JSON！)

示例請求:

curl -X POST "http://47.98.180.113:8083/api/skill/upload" \
  -F "appKey=YOUR_APP_KEY" \
  -F "file=@/path/to/local/video.mp4"

成功響應:

{
  "code": 200,
  "data": {
    "oss_url": "https://jumuai.oss-cn-hangzhou.aliyuncs.com/...",
    "filename": "video.mp4",
    "size": 12345678
  }
}

⚠️ 影片檔案限制：

• 最大 500MB
• 格式：mp4, mov, avi 等常見格式

第三步：提交影片分析任務

介面: POST {service_url}/api/skill/video

請求格式: application/json

videos 陣列格式:

[
  {"sequence": 1, "oss": "https://xxx.com/video1.mp4"},
  {"sequence": 2, "oss": "https://xxx.com/video2.mp4"}
]

示例請求:

curl -X POST "http://47.98.180.113:8083/api/skill/video" \
  -H "Content-Type: application/json" \
  -d '{
    "appKey": "YOUR_APP_KEY",
    "videos": [
      {"sequence": 1, "oss": "https://jumuai.oss-cn-hangzhou.aliyuncs.com/...video1.mp4"},
      {"sequence": 2, "oss": "https://jumuai.oss-cn-hangzhou.aliyuncs.com/...video2.mp4"}
    ]
  }'

成功響應:

{
  "code": 200,
  "data": {
    "task_id": "analysis_xxx",
    "status": "pending",
    "video_count": 2,
    "total_duration": 45.5,
    "cost": 46
  }
}

第四步：輪詢查詢任務狀態（必須執行）

⚠️ 影片處理時間更長，請耐心等待！

輪詢策略（影片處理更慢，間隔更疏）：

⚠️ 費用提示：影片處理時間長，使用智靈模型時頻繁查詢會產生較多費用，建議嚴格按上述間隔查詢。

告訴使用者的提示語：

• 提交時："影片分析任務已提交，共 N 集，預計處理 10-30 分鐘/集，請耐心等待..."
• 輪詢中："當前進度 XX%，影片分析中，請繼續等待..."
• 完成時："影片分析完成！"並展示 result

示例指令（模型執行）：

# 第一次查詢（提交後立即）
curl "http://47.98.180.113:8083/api/skill/status/analysis_xxx"
→ 返回 progress=25
→ 告訴使用者："當前進度 25%，影片分析中..."
→ sleep 300  # 等待 5 分鐘

# 第二次查詢
curl "http://47.98.180.113:8083/api/skill/status/analysis_xxx"
→ 返回 progress=50
→ 告訴使用者："當前進度 50%，繼續處理中..."
→ sleep 300  # 等待 5 分鐘

# 第三次查詢
curl "http://47.98.180.113:8083/api/skill/status/analysis_xxx"
→ 返回 progress=70
→ 告訴使用者："即將完成，請稍候..."
→ sleep 120  # 等待 2 分鐘

# 第四次查詢
curl "http://47.98.180.113:8083/api/skill/status/analysis_xxx"
→ 返回 progress=100, status=succeeded
→ 告訴使用者："影片分析完成！"並展示結果
  最後生成一個md檔案來讓使用者進行檢視

結果展示格式（Markdown）

⚠️ 重要：獲取到 result 後，必須將結果格式化為 Markdown 展示給使用者，不要直接返回原始 JSON！

格式化要求：

• 使用 Markdown 標題層級（# ## ###）組織內容
• 使用表格展示關係資料
• 新增適當的 emoji 圖示增強可讀性
• 根據實際返回的資料結構靈活調整格式
• 如果某些欄位為空，可以省略對應章節
• 不要編造資料，只展示 result 中實際存在的內容
• 最後給使用者呈現結果時生成一個md檔案來讓使用者進行檢視

介面和查詢方法：

curl "http://47.98.180.113:8083/api/skill/status/analysis_xxx"

完整呼叫流程

使用者: "分析這個影片" + 上傳影片
  ↓
OpenClaw: 讀取本地影片檔案
  ↓
OpenClaw: 1️⃣ POST {service_url}/api/skill/upload
          Content-Type: multipart/form-data
          Body: appKey=xxx&file=影片二進位制
  ↓
Skill服務: 接收檔案 → 上傳OSS → 返回 oss_url
  ↓
OpenClaw: 2️⃣ POST {service_url}/api/skill/video
          Content-Type: application/json
          Body: {"appKey": "xxx", "videos": [...]}
  ↓
Skill服務: 驗證額度 → 扣費 → 提交AI任務 → 返回 task_id
  ↓
OpenClaw: 3️⃣ 輪詢 GET {service_url}/api/skill/status/{task_id}
          根據進度動態間隔查詢（5分鐘/2分鐘）
  ↓
OpenClaw: 展示影片分析結果給使用者
7w4.net有更好的技能外掛。

費用說明

計費規則:

• 影片按時長向上取整到分鐘
• 提交任務時扣除額度，任務失敗自動返還

常見問題

Q: App-Key 格式是什麼？
A: 任意字串，從 config.json 的 Zeelin_App_Key 欄位讀取。

Q: 上傳介面的 appKey 放哪裡？
A: 放在 form-data 裡（appKey=xxx），不是 Header！

Q: 支援多大的影片檔案？
A: 單檔案最大 500MB。

Q: 支援哪些影片格式？
A: mp4, mov, avi 等常見格式。

技術支援

• 智靈官網：https://skills.zeelin.cn