dsh-seedance2：DeepSeek Harness 上的 Seedance 2 圖像與視頻生成

前言¶

在 DeepSeek Harness (DSH) 的開發中，當智能體需要生成圖像或視頻時，通常需要自行封裝 HTTP 調用邏輯。dsh-seedance2 是一個插件，通過 Seedance 2 AI 公共 API，將圖像和視頻生成能力直接集成到 Harness 中。該插件由 SynMind AI 維護，支持通過 Seedance 2 或 2.5 模型進行生成。

安裝與啓用¶

安裝插件需要使用 DSH 的插件管理命令。安裝完成後，需要檢查配置轉儲以確認插件已生效。

npx -y @deepseek-ai/dsh plugin --profile web add dsh-seedance2
npx -y @deepseek-ai/dsh --profile web --dump-config
npx -y @deepseek-ai/dsh web --profile web

上述命令會將 seedance2 配置層添加到 Harness 中。如果需要從本地代碼倉庫安裝，可以使用：

npx -y @deepseek-ai/dsh plugin --profile web add .

配置與認證¶

插件通過 Harness 的憑證系統解析 API 密鑰，該密鑰不會作爲模型參數直接暴露在 Prompt 中。

在 Seedance 2 官網註冊或登錄，併購買積分。
在 API 管理頁面創建 API Key。
在啓動 Harness 的環境中設置環境變量：

export SEEDANCE2_PUBLIC_API_KEY='sk-...'

重啓 Harness。

核心功能¶

該插件提供以下核心能力：

seedance2_generate_image：生成圖像。
seedance2_generate_video：生成視頻。
seedance2_get_task：獲取任務狀態。
seedance2_account_help：賬戶幫助。

典型用法¶

以下是插件支持的使用示例。所有參考資料必須使用公共 HTTPS URL。

圖像生成
使用 Seedance 2 AI Nano Banana Pro 生成一個 1:1、2K 級別的優質包裝效果圖，背景爲乾淨的攝影棚地板。
視頻生成
使用 Seedance 2 Pro，將一張公開的 HTTPS 開場圖像轉換爲 5 秒鐘的 720p 16:9 視頻。要求使用慢推鏡頭效果，並生成音頻。
媒體到視頻
使用 Seedance 2.5，基於公開的 HTTPS 參考圖像和視頻生成視頻。在 Prompt 中明確說明每個參考素材的作用。

提示詞與參考資源¶

爲了獲得最佳效果，在 Prompt 中應包含以下要素：
* 主體
* 動作
* 場景
* 相機運動
* 視覺風格
* 約束條件
* 參考素材的角色

配置項¶

默認配置已具備生產環境可用性，僅在必要時覆蓋。配置文件位置爲 $DSH_HOME/profiles/web/cordis.patch.yml。

- id: seedance2
  config:
    apiBaseUrl: https://www.seedance2ai.io
    apiKeyEnv: SEEDANCE2_PUBLIC_API_KEY
    requestTimeoutMs: 30000
    pollIntervalMs: 3000
    imageWaitTimeoutMs: 300000
    videoWaitTimeoutMs: 900000
    maxRetries: 2
    retryDelayMs: 500
    requireApproval: true
    allowLocalHttp: false

行爲與錯誤處理¶

冪等與重試：付費請求攜帶 Idempotency-Key，自動重試會複用該鍵。對於可重試的 429 和 5xx 響應，插件使用有界退避策略。
取消：取消操作會中止正在進行的請求和前臺輪詢。
超時處理：如果前臺等待超時，應繼續使用 seedance2_get_task 查詢原始任務，避免重複付費提交。
退款信息：任務失敗時會顯示 API 返回的 credits_refunded。
憑證限制：插件不接受內部憑證（如 SEEDANCE_API_KEY），僅接受通過 Harness 環境變量傳遞的公共憑證。

生態與總結¶

該插件通過 Harness 的憑證管理解決了 API 密鑰的安全暴露問題，並內置了重試、退避和超時處理邏輯，降低了集成外部視頻生成模型的成本。相關文檔與源碼位於社區目錄與 GitHub 倉庫。