前言¶

在 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