runway_act_one

runway-act-one 的技術規格

什麼是 runway-act-one？

runway-act-one 是 CometAPI 對 Runway 之 Act-One 模型/工作流程的平臺識別符，是一種將錄製的表演轉移到目標角色上的角色動畫系統。依 Runway 的說明，使用者上傳驅動表演，藉此影響角色參考圖片或影片，特別是表情、口型與臉部表演。

在實務上，runway-act-one 很適合用於說話角色片段、風格化人像動畫、AI 虛擬形象鏡頭，以及當你需要比僅靠文字提示生成更可控的表演驅動臉部動畫。Runway 的指引強調，最佳結果來自光線充足、正面朝向的人類單一人臉輸入，且在整個鏡頭中臉部始終可見。

儘管 Act-One 在 Runway 的說明文件中被描述為 Gen-3 Alpha 與 Turbo 創作流程的一部分，但以程式方式整合 Runway 的開發者應理解其 API 採任務制、使用 Bearer Token 驗證，並透過 X-Runway-Version 標頭進行版本化。

runway-act-one 的主要功能

• 專注表演驅動的臉部動畫：將來源表演轉移到目標角色，使表情與口型跟隨驅動影片，而非僅依賴文字提示。
• 支援角色圖片或影片作為輸入：可使用靜態角色參考圖片以獲得更穩定的輸出，或使用角色參考影片以獲得更大的動作彈性。
• 精準影響表情與口型同步：Runway 明確定位 Act-One 可精準影響表情、口部動作與相關臉部行為。
• 可調式運動強度：提供 1 至 5 的 Motion Intensity 控制，可在穩定與表現力之間調整。
• 友善人像的製作規格：既支援橫向也支援縱向輸出，幀率為 24 fps，輸出時長最長可達 30 秒。
• 以最佳實務提升可靠性：Runway 提供具體輸入指引，如從肩膀以上的構圖、正面朝向、遮擋最少且臉部持續可見，以提升成功率與品質。
• 相容任務式 API：在開發者工作流程中，Runway 的 API 採用受驗證的任務提交與結果查詢模式，適合非同步產線。
• 可重用素材導入選項：Runway 支援 HTTPS 直接輸入與透過 runway:// URI 上傳的短暫資產，有助於自動化媒體密集的流程。

如何存取並整合 runway-act-one

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

要呼叫 runway-act-one，先在 CometAPI 建立帳號並於主控台產生 API 金鑰。將其安全地存放為環境變數，讓應用程式能在不將密鑰硬編碼進原始碼的情況下驗證請求。

步驟 2：向 runway-act-one API 發送請求

使用 CometAPI 與 Runway 相容的端點 POST /runway/pro/act_one。

curl https://api.cometapi.com/runway/pro/act_one \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $COMETAPI_API_KEY" \
  -d '{
    "prompt": "Your prompt here."
  }'

步驟 3：擷取並驗證結果

API 會回傳一個任務物件。使用任務 ID 透過 POST /runway/feed 輪詢任務狀態，以確認生成何時完成，然後擷取輸出 URL。