前言¶
在对话里直接说「生成一段日落视频」或「让这张图动起来」，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
