前言¶

在 Agent 里接豆包文生图、图生图或文生视频时，常见做法是再挂一层 MCP 服务，或手写 curl 去拼 Ark 请求。视频任务还要单独轮询 task_id、再下载 video_url，对话里很容易断链。

下面介绍的 Skill 把图片与视频生成收成一套原生能力：由 Agent 按 SKILL.md 调用本地 python3 脚本，直接请求火山引擎 Ark 北京接入点，不依赖外部 MCP。官方说明强调使用接入点（endpoint），而不是绕过控制台配置直调模型名。

这是什么¶

豆包图片与视频生成原生技能（坐标 @user_9aa92135/doubao-image-video）是 SkillHub 社区技能，分类为 design-media，发布者为 user_9aa92135，当前 SkillHub 页面标注版本为 v1.0.0。页面标签为「需配置 API Key」，并标明能力方向为图片生成与视频处理。

技能包内带 scripts/doubao_media.py 与 references/api-notes.md，属于通用 SKILL.md 格式。当用户提到豆包、文生图、图生图、文生视频、图生视频、查询视频任务、等待完成或下载成品视频时，Agent 应优先走本技能，而不是默认拉起上游 MCP（除非用户明确要求 MCP 兼容）。

核心功能¶

以下能力均来自技能包 SKILL.md 与 references/api-notes.md，已与安装包核对。

图片生成¶

• 文生图，以及通过 --image-url、--ref-image-url 做图生图或多参考图生成。
• 请求：POST https://ark.cn-beijing.volces.com/api/v3/images/generations。
• 优先使用 --endpoint-id 或环境变量 DOUBAO_IMAGE_ENDPOINT_ID；缺失时可回退到 --model 或默认模型环境变量。

视频生成与异步任务¶

• 文生视频、图生视频（首帧 --first-frame-image-url、参考图 --ref-image-url）。
• 创建任务：POST https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks。
• 查询任务：GET https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/{task_id}。
• 视频为异步流程；成功后会得到 task_id，可用 task 子命令查询，或用 wait 轮询并在成功后按 content.video_url 下载。
• 脚本会在 prompt 中按需追加 --dur、--fps、--rs、--ratio（与上游实现保持一致）；720p 时 ratio 为 16:9，否则为 adaptive。

运行依赖¶

• 需要本机 python3（技能元数据 openclaw.requires.bins）。
• 必填环境变量：DOUBAO_API_KEY（火山引擎 Ark API Key）。
• 可选：DOUBAO_IMAGE_ENDPOINT_ID、DOUBAO_VIDEO_ENDPOINT_ID；默认模型名 DOUBAO_DEFAULT_IMAGE_MODEL（默认 doubao-seedream-4-5）、DOUBAO_DEFAULT_VIDEO_MODEL（默认 doubao-seedance-1.0-lite-t2v）。

安装与启用¶

方式一：让 Agent 按官方提示安装¶

SkillHub 页面给出的安装提示为：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_9aa92135/doubao-image-video`。

把上述内容发给当前使用的 AI Client，由 Agent 读取 SkillHub 安装文档并完成安装。

方式二：SkillHub CLI¶

先确认是否已安装 CLI（文档见 https://skillhub.cn/install/skillhub.md）：

command -v skillhub && skillhub --version

未安装时可执行完整安装或仅 CLI：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。常用路径如下（摘自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

示例（将目录换成你环境对应路径）：

skillhub install @user_9aa92135/doubao-image-video --dir ~/.cursor/skills

页面还支持 Zip 包安装、安装到本地 Agent 等入口；与 CLI 二选一即可。

配置 API Key 与接入点¶

在 Agent 运行环境中设置：

export DOUBAO_API_KEY="你的火山引擎 Ark API Key"
# 建议在控制台创建并授权后填写接入点 ID
export DOUBAO_IMAGE_ENDPOINT_ID="图片接入点 ID"
export DOUBAO_VIDEO_ENDPOINT_ID="视频接入点 ID"

技能说明要求：有已开通的 Ark 接入点时，优先 --endpoint-id 或上述环境变量，而不是假设任意模型名一定可用。

典型用法¶

下列命令来自 SKILL.md，{baseDir} 需替换为技能安装目录（例如 ~/.cursor/skills/@user_9aa92135/doubao-image-video）。

文生图¶

python3 {baseDir}/scripts/doubao_media.py image \
  --prompt "A cinematic cyberpunk alley in rain" \
  --size 2560x1440

文生视频¶

python3 {baseDir}/scripts/doubao_media.py video \
  --prompt "A panda astronaut waves on the moon" \
  --video-duration 5 \
  --fps 24 \
  --resolution 1080p

查询视频任务¶

python3 {baseDir}/scripts/doubao_media.py task --task-id your-task-id

等待任务并下载 MP4¶

python3 {baseDir}/scripts/doubao_media.py wait \
  --task-id your-task-id \
  --timeout 600 \
  --interval 5 \
  --download-to ./doubao-result.mp4

脚本输出为结构化 JSON，不打印密钥；出错时返回简明错误信息。若 API 返回 InvalidEndpointOrModel.NotFound，应先核对 Ark 控制台里接入点是否已创建并完成授权。

图生图、图生视频时，若用户提供图片 URL，按原样传入 --image-url / --first-frame-image-url / --ref-image-url，除非用户要求，不要自行下载或转存。

适用场景与注意¶

适合谁

• 已在火山引擎开通 Ark、并愿意用接入点管理豆包图片/视频模型的开发者。
• 希望 Cursor、Claude Code、Codex 等客户端在对话里完成「生成 → 查任务 → 下载视频」全链路，又不想维护单独 MCP 进程的团队。

限制与注意

• 必须配置 DOUBAO_API_KEY；无 Key 时脚本会直接失败。
• 视频 prompt 长度上限 500 字符（脚本内校验）。
• 技能定位为原生 OpenClaw 能力；上游 GitHub 项目 doubao-image-video-mcp 在元数据里作为 homepage 引用，日常不应默认启动 MCP 服务。
• SkillHub 页面显示该技能经科恩实验室、云鼎实验室安全扫描为无风险；仍须自行保管 API Key，勿提交到仓库。

SkillHub 侧统计（以抓取资料为准）：评分 100000，下载约 1.15 万次，安装 117 次；页面亦显示约 1.2 万次下载，属同一量级。

结尾¶

豆包图片与视频生成原生技能把豆包相关的图片与视频 Ark 调用、异步任务查询和结果下载收敛到一份 SKILL.md 和单个 Python 脚本里，适合作为 Agent 的默认豆包多媒体工具链。

官方 SkillHub 页面：https://www.skillhub.cn/skills/user_9aa92135/doubao-image-video
技能坐标页：https://api.skillhub.cn/user_9aa92135/doubao-image-video