runwayml_video_to_video

runwayml-video-to-video 的技術規格

什麼是 runwayml-video-to-video？

runwayml-video-to-video 是 CometAPI 的平台識別符，用於對應 Runway 的 video-to-video 生成能力，這是一種將現有影片轉換為全新風格化或重新詮釋版本的模型工作流程。它並非從零生成動態，而是從上傳的片段出發，在保留來源素材的運動與時間結構的同時，套用由提示驅動的視覺變化。

Runway 將 Video to Video 描述為透過文字提示或以輸入影像作為首幀引導，來改變影片風格的方法。實務上，這讓該模型適用於創意再渲染、電影風格再設計、氛圍轉換、美術指導實驗，以及將原始素材轉化為更精緻或概念導向的視覺輸出。

此模型屬於 Runway 更廣泛的影片生成產品線。依據目前的 Runway 文件，Gen-4 Aleph 是較新且推薦的 video-to-video 編輯選項，而 Gen-3 Alpha 與 Gen-3 Alpha Turbo 則是此工作流程較早期的實作並仍有文檔記載。這表示 runwayml-video-to-video 更應被理解為針對既有 Runway 風格的影片轉換任務的實用型轉換模型，而非 Runway 產品目錄中最新的旗艦級編輯系統。

runwayml-video-to-video 的主要特性

• 影片引導生成：從上傳的來源影片開始，適合在保留動作結構的同時，改變外觀、風格或場景美學。
• 基於提示的風格化：支援文字提示描述目標外觀，協助創作者引導調性、視覺識別與轉換風格。
• 圖像輔助控制：可使用影像作為首幀引導，更明確地引導構圖或視覺方向。
• 短片製作流程：支援最長 20 秒的片段，適用於廣告、社群內容、概念鏡頭與快速創意迭代。
• 多層級品質／成本：Runway 記載 Gen-3 Alpha 與 Gen-3 Alpha Turbo 版本，其中 Turbo 被定位為較低成本選項。
• 高解析度輸出：輸出記載為 1280×768；Turbo 亦提供縱向 768×1280，支援橫式與部分直式工作流程。
• 創意編輯用例：最適合風格轉換、素材再渲染、概念可視化，及將拍攝素材轉為更具電影感或品牌化的輸出。此為基於 Runway 所述的 Video to Video 行為與工作流程之推論。

如何存取並整合 runwayml-video-to-video

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

要存取 runwayml-video-to-video API，請先在 CometAPI 註冊帳號，並於儀表板產生 API 金鑰。CometAPI 提供統一的 API 介接層，您可使用相同的帳號與金鑰管理流程來存取受支援的模型。

請妥善保存 API 金鑰，並在正式環境中透過環境變數載入。例如：

export COMETAPI_API_KEY="your_api_key_here"

步驟 2：向 runwayml-video-to-video API 發送請求

取得 API 金鑰後，使用模型 ID runwayml-video-to-video 對 CometAPI 的生成端點發送請求。

範例請求：

curl https://api.cometapi.com/v1/responses \
  -H "Authorization: Bearer $COMETAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "runwayml-video-to-video",
    "input": {
      "video": "https://example.com/input-video.mp4",
      "prompt": "Transform this clip into a cinematic neon-lit sci-fi scene with dramatic atmosphere"
    }
  }'

步驟 3：擷取並驗證結果

提交後，從 API 回應負載中擷取生成結果，或在請求以非同步方式處理時，透過輪詢 job/status 端點取得狀態。於投入正式流程前，請確認回傳輸出符合所要求的格式、時長與轉換意圖。

常見檢查項包含：輸出是否可用、渲染是否完整、視覺一致性，以及風格化是否符合提示與來源影片。