前言¶
在對話裏直接說「生成一段日落視頻」或「讓這張圖動起來」，Agent 需要知道該調哪套 API、本地圖要不要先上傳、任務創建後如何輪詢結果。自己拼 curl、記端點差異（文生走 generations、圖生走 chat completions），成本高且容易漏步驟。
下面介紹 SkillHub 上的社區 Skill「火山引擎Seedance」（座標 @user_ea6f9f3a/volcengine-seedance，版本 1.0.0）。它把火山引擎 Seedance 相關能力寫成通用 SKILL.md，並附帶上傳腳本與調用約定，可裝進 Cursor、Claude Code、OpenClaw、WorkBuddy 等支持 Skills 的 Agent，由模型按文檔代你完成創建任務與查狀態。
這是什麼¶
一句話定位：通過 AI 聚合平臺調用火山引擎 Seedance，在 Agent 側完成文生視頻、圖生視頻、圖片上傳與任務查詢。
維護與來源：SkillHub 分類爲 design-media，來源爲 community，發佈者爲 user_ea6f9f3a。頁面標註 requires_api_key=true，使用前需配置 API Key。SkillHub 當前評分 100000，下載 1235 次（以 SkillHub 頁面與抓取資料爲準）。
解決的問題：把模型列表、端點、認證、上傳與輪詢策略寫進 Skill，減少 Agent 每次從零查文檔；官方簡介亦說明可導入 WorkBuddy、OpenClaw 等 Agent 工具使用。
技能文檔寫明：實際請求發往 https://api.opsmoneye.com，認證爲 Bearer Token；API Key 需在 https://api.opsmoneye.com 用戶中心的 Token 管理中獲取（格式 sk-xxxxxxxxx）。
核心功能¶
以下能力均來自技能包內 SKILL.md 的功能表與說明：
| 能力 | 端點 | 方法 |
|---|---|---|
| 上傳圖片 | /api/upload/image |
POST |
| 文生視頻 | /v1/images/generations |
POST |
| 圖生視頻 | /v1/chat/completions |
POST（多模態 messages） |
| 任務查詢 | /v1/aigc/task/{task_id} |
GET |
模型（節選）：doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128、doubao-seedance-2-0、doubao-seedance-2-0-fast。
時長與計費：文檔說明按秒計費，時長支持 4–15 秒整數，並對過小或過大入參做校準；不傳或非法值時默認 5 秒。具體價格以平臺計費說明爲準。
依賴：OpenClaw 元數據要求本機可用 python，圖生場景需先通過 scripts/upload_image.py 將本地圖轉爲公網 URL（JPG/PNG/GIF/WebP/BMP，單文件 ≤10MB）。
安裝與啓用¶
1. 安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已安裝：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 安裝文檔執行完整安裝：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝說明全文見：https://skillhub.cn/install/skillhub.md
2. 安裝本 Skill¶
官方頁面提示：請根據上述安裝文檔，安裝 @user_ea6f9f3a/volcengine-seedance。命令行示例（--dir 必須指向當前 Agent 的 skills 目錄，否則默認 ./skills/ 可能無法被識別）：
skillhub install @user_ea6f9f3a/volcengine-seedance --dir <你的 Agent skills 目錄>
常見路徑（摘自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下.agents/skills/ - WorkBuddy：
~/.workbuddy/skills/
也可將提示詞發給 AI：「請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_ea6f9f3a/volcengine-seedance。」
3. 配置 API 與環境變量¶
在 OpenClaw 等環境中，技能文檔建議設置：
export ONEAPI_BASE_URL="https://api.opsmoneye.com"
export ONEAPI_TOKEN="sk-你的API令牌"
或在 OpenClaw 配置中：
env:
ONEAPI_BASE_URL: "https://api.opsmoneye.com"
ONEAPI_TOKEN: "sk-你的API令牌"
所有示例裏的 YOUR_TOKEN 需替換爲真實 Key。上傳腳本同樣依賴 ONEAPI_BASE_URL 與 ONEAPI_TOKEN。
典型用法¶
文生視頻¶
用戶只有文字描述時，調用文生端點。下面用 curl 創建任務（將 YOUR_TOKEN 換成你的 Key）：
curl --location --request POST 'https://api.opsmoneye.com/v1/images/generations' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'Content-Type: application/json; charset=utf-8' \
--data-raw '{
"model": "doubao-seedance-2-0-260128",
"prompt": "美麗的日落，海浪輕拍沙灘，電影級光照",
"size": "1920x1080",
"duration": 10
}'
響應中會包含 task_id 與 PROCESSING 狀態；隨後用任務查詢端點輪詢。
圖生視頻（本地圖）¶
- 上傳圖片（路徑爲技能目錄下的腳本，安裝後
{baseDir}對應當前 Skill 根目錄）：
python3 {baseDir}/scripts/upload_image.py /path/to/image.jpg
- 使用返回 JSON 中的
url，調用圖生端點：
curl --location --request POST 'https://api.opsmoneye.com/v1/chat/completions' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'Content-Type: application/json; charset=utf-8' \
--data-raw '{
"model": "doubao-seedance-2-0-260128",
"messages": [{
"role": "user",
"content": [
{"type": "text", "text": "讓畫面中的花朵隨風搖曳"},
{"type": "image_url", "image_url": {"url": "https://api.opsmoneye.com/uploads/2026/04/21/xxx.jpg"}}
]
}],
"size": "1920x1080",
"duration": 10
}'
若用戶已提供可公網訪問的 HTTPS 圖片 URL，可跳過上傳，直接在 image_url 中使用該地址。
查詢任務狀態¶
curl https://api.opsmoneye.com/v1/aigc/task/cgt-20260421140001-mz4n5 \
-H "Authorization: Bearer YOUR_TOKEN"
技能建議每 8 秒查詢一次；status 爲 SUCCESS 時從 result_url 取視頻地址。連續輪詢 10 分鐘仍無結果時，應提示用戶稍後憑 task_id 再查，且不要因等待而重複創建任務。
在 Agent 對話中，用戶可直接說「幫我生成日落視頻」或發送圖片並描述動效；啓用本 Skill 後，模型應按文檔選擇文生或圖生流程，並儘量原樣傳遞用戶 prompt（技能明確要求勿擅自擴寫描述）。
適用場景與注意¶
適合誰
- 已在 SkillHub 生態中使用 Cursor、Claude Code、OpenClaw、WorkBuddy 等，希望在對話裏完成 AI 視頻生成。
- 需要統一封裝文生 / 圖生 / 上傳 / 查任務，而不是每次手寫 HTTP 調用。
限制與注意
- 必須自備
api.opsmoneye.com的 API Key；未配置或 Key 錯誤會出現 Unauthorized 類錯誤。 - 圖生視頻不能使用本地路徑，本地文件必須先上傳或使用公網 URL。
- 視頻生成多爲異步，需輪詢；文檔提到常見等待約 3–8 分鐘，以實際任務爲準。
- 任務
FAILED時文檔說明會自動退款；計費與額度以平臺規則爲準。 - 本 Skill 爲社區發佈，與火山引擎官方控制台無直接綁定關係；接入鏈路以技能文檔中的 Base URL 與端點爲準。
結尾¶
火山引擎 Seedance Skill 把文生視頻、圖生視頻、圖片上傳和任務查詢收斂成 Agent 可執行的說明與腳本，適合在對話裏快速試視頻能力。安裝與詳情見 SkillHub：
- 頁面：https://www.skillhub.cn/skills/user_ea6f9f3a/volcengine-seedance
- 座標：
@user_ea6f9f3a/volcengine-seedance
