使用 Danceo 製作 AI 舞蹈影片
當使用者要求使用 Danceo 可用參考範本中的舞蹈動作來讓一張人像照片動起來時,請使用此技能。此工作流程會進行渲染,並從已設定的 API 金鑰所綁定的帳戶中扣除點數。
工作流程
- 如果使用者尚未提供可公開存取的 HTTPS 圖片網址,請詢問要使用哪張人像圖片。確認使用者有權轉換此圖片及其肖像。
- 開始渲染前,呼叫
get_credits。回報取得的點數餘額;不要假設帳戶有免費試用點數。 - 呼叫
list_dance_templates並選擇符合所要求動作的範本。使用其傳回的id,切勿修改。 - 確認要求的輸出長度介於 5 至 30 秒之間,且不超過所選參考範本的長度。對於貓咪範本,需提供
imageCount指定的肖像數量;對於人物或狗,則只需提供一張肖像。 - 根據當前 API 定價,預估每輸出秒數需要 80 點數。檢查帳戶點數餘額是否足夠支付,然後請求使用者確認,除非使用者已經明確授權進行付費渲染。只有在獲得確認後才呼叫
create_dance_video。 - 保留傳回的
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。 - 若工作處於待處理或處理中狀態,請繼續以合理的間隔輪詢;除非使用者要求,否則不要建立重複的工作。
相關連結
- 產品與 MCP 指南:https://danceo.ai/mcp
- 定價:https://danceo.ai/pricing