Communitygithub.com

ai-dance-video

當使用者想要從人像照片製作 AI 舞蹈影片、讓照片跳舞、選擇舞蹈參考模板或檢查 Danceo 渲染狀態時使用。需要 Danceo Video MCP 伺服器和 API 金鑰。

ai-dance-video 是什麼?

此技能專為讓使用者從靜態人像照片生成 AI 舞蹈影片而設計,透過 Danceo 服務及其中一個預設舞蹈範本實現。首先需確認使用者提供可公開存取的 HTTPS 人像圖片,並確認其擁有使用該圖像的權限。接著,技能會檢查 API 帳戶的點數餘額、列出可用舞蹈範本,並協助選擇最符合要求的模板。輸出影片長度必須在 5 到 30 秒之間,且不得超過所選範本的原始長度。技能會根據當前 API 定價(每秒 80 點數)估算渲染成本,並在使用者確認後才呼叫 `create_dance_video`。最後,技能會持續輪詢渲染狀態,直到成功或失敗,並將結果 URL 回報給使用者。此技能支援 Danceo 平台,並處理常見錯誤,如金鑰無效、點數不足或未知範本。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jasonliu119/danceo-ai-dance-mcp-skills/tree/main/skills/ai-dance-video

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

使用 Danceo 製作 AI 舞蹈影片

當使用者要求使用 Danceo 可用參考範本中的舞蹈動作來讓一張人像照片動起來時,請使用此技能。此工作流程會進行渲染,並從已設定的 API 金鑰所綁定的帳戶中扣除點數。

工作流程

  1. 如果使用者尚未提供可公開存取的 HTTPS 圖片網址,請詢問要使用哪張人像圖片。確認使用者有權轉換此圖片及其肖像。
  2. 開始渲染前,呼叫 get_credits。回報取得的點數餘額;不要假設帳戶有免費試用點數。
  3. 呼叫 list_dance_templates 並選擇符合所要求動作的範本。使用其傳回的 id,切勿修改。
  4. 確認要求的輸出長度介於 5 至 30 秒之間,且不超過所選參考範本的長度。對於貓咪範本,需提供 imageCount 指定的肖像數量;對於人物或狗,則只需提供一張肖像。
  5. 根據當前 API 定價,預估每輸出秒數需要 80 點數。檢查帳戶點數餘額是否足夠支付,然後請求使用者確認,除非使用者已經明確授權進行付費渲染。只有在獲得確認後才呼叫 create_dance_video。
  6. 保留傳回的 job_id。以合理的間隔呼叫 get_video_status,直到狀態變為 success 或 failed。若成功,回傳影片 URL;若失敗,回傳服務錯誤訊息及後續步驟。

輸入限制

  • 人像圖片必須能透過 HTTPS 公開存取。
  • 此 API 僅接受由 list_dance_templates 傳回的 Danceo 展示參考;不接受任意的參考影片 URL。
  • 輸出長度必須是從 5 到 30 之間的整數,且不得超過所選參考範本的長度。在長片處理功能不可用時,服務可能會強制設定更短的最大值。
  • 目前 API 渲染成本為每秒輸出 80 點數。Danceo 會在建立回應中報告最終成本,並從 API 金鑰擁有者的帳戶餘額中扣款。渲染失敗時,Danceo 會根據其點數歸還政策處理。

良好的請求範例

  • 使用清晰、光線良好、臉部與主體明顯可見的人像。
  • 選擇構圖和動作都適合該人像的參考範本。
  • 在與參考編排相容的前提下,盡量保留使用者要求的身份、姿勢和視覺方向。
  • 不要製造欺騙性的冒充行為,也未經許可不得轉換他人的肖像。尊重隱私、版權和平台規則。

錯誤處理

  • 若 API 金鑰無效,請引導使用者前往 Danceo API 金鑰設定。
  • 若點數不足,請使用 get_credits 檢查餘額,並引導使用者參考 Danceo 定價頁面。
  • 若範本未知,請重新呼叫 list_dance_templates 並使用其中傳回的 ID。
  • 若工作處於待處理或處理中狀態,請繼續以合理的間隔輪詢;除非使用者要求,否則不要建立重複的工作。

相關連結

相關技能