runway_video2video

runway-video2video 的技術規格

什麼是 runway-video2video?

runway-video2video 是 CometAPI 用於標識 Runway video-to-video 生成能力的模型 ID。該工作流程接收現有影片片段，並在文字提示的引導下，將其重新渲染為新的視覺風格或基於動態的演繹。實務上，常用於風格化、場景轉換、視覺外觀開發、實驗性 VFX，以及將原始素材轉化為更具電影感或想像力的輸出。

Runway 的說明文件將 Video to Video 描述為使用文字提示或以輸入圖片作為第一幀來改變影片風格的方法。較新的產品指引亦指出，儘管 Gen-3 Alpha 與 Turbo 支援此工作流程，Runway 目前更建議在最新的 video-to-video 用例中採用新一代工具。從 CometAPI 整合的角度來看，runway-video2video 是用於存取此類能力的平台模型 ID。

runway-video2video 的主要功能

• 影片引導的生成：從現有的影片輸入出發，而非從零生成動作，因此在改變視覺結果的同時，有助於保留鏡頭結構、節奏與構圖。
• 基於提示的轉換：使用自然語言指令控制輸出風格、氛圍、主體再詮釋或視覺效果方向。
• 風格遷移與創意重渲染：適合在不需逐幀手動編輯的情況下，將素材轉化為動畫化、電影感、超現實或品牌化的視覺處理。此為根據 Runway 所描述的 video-to-video 風格化流程所作的推斷。
• 參考導向的流程：Runway 文件指出在相關影片生成流程中支援以圖片作為引導，有助於引導構圖或維持美學一致性。
• 直式與橫式輸出選項：支援的流程包含標準橫向與縱向輸出格式，便於社群、行動與行銷投放。
• 短內容製作效率：所述流程支援最長 20 秒的短片段，適合廣告創意、概念鏡頭、社群貼文與快速迭代流程。
• API 可用性：Runway 提供 API 文件與模型存取方式，便於程式化整合至創意應用、內部工具與自動化媒體流程。

如何存取並整合 runway-video2video

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

開始前，請在 CometAPI 註冊，並於儀表板產生你的 API 金鑰。取得金鑰後請妥善保存，並用於向 CometAPI 端點進行身份驗證。

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

透過 CometAPI 使用 Runway 的官方 API 格式。端點為 POST /runwayml/v1/video_to_video。你必須包含 X-Runway-Version 標頭。

curl https://api.cometapi.com/runwayml/v1/video_to_video \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $COMETAPI_API_KEY" \
  -H "X-Runway-Version: 2024-11-06" \
  -d '{
    "model": "gen4_aleph",
    "videoUri": "https://example.com/your-source-video.mp4",
    "promptText": "Transform this footage into a cinematic neon-lit sci-fi sequence with dramatic atmosphere and smooth motion.",
    "seed": 1,
    "ratio": "1280:720",
    "references": [],
    "contentModeration": {
      "publicFigureThreshold": "auto"
    }
  }'

import os, requests

resp = requests.post(
    "https://api.cometapi.com/runwayml/v1/video_to_video",
    headers={
        "Authorization": f"Bearer {os.environ['COMETAPI_API_KEY']}",
        "Content-Type": "application/json",
        "X-Runway-Version": "2024-11-06",
    },
    json={
        "model": "gen4_aleph",
        "videoUri": "https://example.com/your-source-video.mp4",
        "promptText": "Transform this footage into a cinematic neon-lit sci-fi sequence.",
        "seed": 1,
        "ratio": "1280:720",
        "references": [],
        "contentModeration": {"publicFigureThreshold": "auto"},
    },
)
print(resp.json())

步驟 3：擷取並驗證結果

API 會回傳一個任務物件。輪詢任務狀態端點以確認影片生成完成時間，然後擷取輸出影片的 URL。用於生產環境時，請加入重試、狀態輪詢與記錄，以確保與 runway-video2video 的可靠整合。