runwayml_character_performance

runwayml-character-performance 的技術規格

什麼是 runwayml-character-performance？

runwayml-character-performance 是 CometAPI 對 Runway 的角色表演生成工作流程的平台識別符，Runway 通常將其稱為 Act-Two。該模型旨在從真人表演片段為角色製作動畫：你提供一段演員的驅動影片，外加角色圖片或影片，系統會將臉部動作、表情、語音時序與身體動作轉移到生成的角色鏡頭中。

此模型針對需要在無傳統動作捕捉裝置下快速完成角色動畫的創作流程而設計。Runway 將其描述為一種以真實動作、語音與表情讓角色栩栩如生的方法，並同時支援非人類角色與多樣化視覺風格。當目標角色為靜態圖片時，系統亦可合成環境運動，使畫面更自然。

在 CometAPI 上，此能力透過 Runway 角色表演端點對外提供，適用於希望以程式化方式存取表演驅動角色動畫的產品團隊、創意工具、原型流程與自動化媒體工作流。（cometapi.com）

runwayml-character-performance 的主要功能

• 表演轉移：將來源影片中的演出表現映射到目標角色，包括臉部動作、表情與更大範圍的身體動作。
• 彈性的角色輸入：可接受角色圖片或角色影片，為開發者在動作控制與場景保留之間提供不同取捨。
• 針對圖片型角色的手勢控制：當使用角色圖片時，模型可從表演片段轉移手勢與身體姿態，實現更具表現力的動畫。
• 場景感知的圖片動畫化：當角色輸入為靜態圖片時，系統會自動添加環境或類攝影機運動，使結果不顯得呆板或僵硬。
• 保留影片內容的角色流程：當角色輸入為影片時，生成結果會在套用臉部表演轉移的同時保留原始主體、場景與攝影機運動。
• 可調的臉部表現力：支援表情強度控制，讓開發者在更強的表演轉移與畫面穩定一致性之間取得平衡。
• 友善製作的輸出選項：支援多種常見長寬比與解析度，固定 24 FPS，適用於橫向、直向、方形與電影感的社群/影片格式。
• 針對短片最佳化：最適合短片段，最短 3 秒、最長 30 秒，涵蓋廣告、社群短片、對白片段、previs 與原型場景等需求。

如何存取並整合 runwayml-character-performance

步驟 1：註冊並取得 API 金鑰

登入 CometAPI。若尚未成為用戶，請先註冊。接著開啟個人中心，建立 API 權杖，並複製金鑰以便後續請求進行驗證。CometAPI 透過其與 Runway 相容的 API 基礎設施提供此模型。（cometapi.com）

步驟 2：向 runwayml-character-performance API 發送請求

使用 CometAPI 的 Runway 角色表演端點，並在應用層將 model 欄位設為 runwayml-character-performance。底層請求流程使用角色表演路由，透過 JSON 輸入提供驅動表演、角色資產、動作控制與輸出設定。（cometapi.com）

curl --location --request POST 'https://api.cometapi.com/runwayml/v1/character_performance' \
  --header 'X-Runway-Version: 2024-11-06' \
  --header 'Authorization: Bearer YOUR_COMETAPI_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "character": {
      "type": "video",
      "uri": "https://your-file-host.example/character.mp4"
    },
    "reference": {
      "type": "video",
      "uri": "https://your-file-host.example/performance.mp4"
    },
    "bodyControl": true,
    "expressionIntensity": 3,
    "seed": 4294967295,
    "model": "runwayml-character-performance",
    "ratio": "1280:720",
    "contentModeration": {
      "publicFigureThreshold": "auto"
    }
  }'

步驟 3：擷取並驗證結果

提交後，在後端或用戶端應用程式中處理 API 回應，並確認生成結果符合預期的片長、構圖與表現品質。實務上，亦應檢查輸入素材是否遵循 Runway 的最佳實務——清晰的單一主體表演畫面、臉部可見、穩定的構圖，以及合適的角色參考——以提升輸出可靠性。（cometapi.com）