runwayml-image-to-video 的技術規格
| 規格 | 詳情 |
|---|---|
| 模型 ID | runwayml-image-to-video |
| 提供方 | Runway |
| 主要能力 | 使用文字提示與基於影像條件的動作生成，從起始影像生成影片。 |
| API 任務類型 | 透過 Runway 的 image-to-video 端點啟動的非同步影像轉影片生成任務。 |
| Runway API 支援的底層模型 | Runway 的 image-to-video 端點接受多種影片模型，包括 gen4_turbo、gen3a_turbo、veo3.1、veo3.1_fast 與 veo3。 |
| 必要輸入 | 一張輸入影像加上模型特定的生成參數；常以提示文字描述期望的運動與場景行為。 |
| 身份驗證 | 在 Authorization 標頭中使用 Bearer API 金鑰。 |
| 版本標頭 | Runway 的 API 參考要求包含 X-Runway-Version 標頭；對於 image-to-video 端點，文件載明的值為 2024-11-06。 |
| 輸出格式 | 透過基於任務的 API 處理返回的生成影片資產。 |
| 典型影格率 | Runway 文件列出 Gen-3 Alpha 的 image-to-video 輸出為 24 fps。 |
| 常見輸出解析度 | Runway 文件記載 Gen-3 Alpha 為 1280×768，Gen-3 Alpha Turbo 視方向支援 1280×768 與 768×1280。 |
| 影像輸入建議 | Runway 建議避免使用小於 640×640 px 或大於 4K 的參考影像作為輸入。 |
| 在 CometAPI 上的使用方式 | 透過 CometAPI 以平台模型識別碼 runwayml-image-to-video 存取。 |
什麼是 runwayml-image-to-video？
runwayml-image-to-video 是 CometAPI 用於存取 Runway 影像轉影片生成功能的模型識別碼。實務上，此類模型以靜態影像為視覺起點，並將其轉換為生成影片，通常由描述運動、鏡頭行為、氛圍或場景演變的提示文字加以引導。
Runway 將 image-to-video 定位為其更廣泛影片生成堆疊的一部分。其 Gen-3 Alpha 文件將 image-to-video 視為將提供的影像動畫化的方法，提示重點特別在於動作，而非重新描述畫面中已可見的一切。
從 API 觀點來看，Runway 以任務建立端點公開 image-to-video 生成，這表示請求通常先啟動一個作業，之後需要輪詢或擷取步驟，在處理完成後取得最終影片結果。
runwayml-image-to-video 的主要功能
- 影像條件化影片生成：從靜態影像出發，生成以運動為驅動的影片輸出，而非僅由文字生成影片。
- 由提示引導的動作控制：當提示描述運動、鏡頭移動與場景變化時效果最佳，使供給的畫面能連貫地被動畫化。
- 非同步任務工作流程：先發起生成請求再擷取結果，適用於會排隊並監控長時間媒體作業的生產系統。
- 多種底層模型選項：支援多個後端影片模型，讓開發者可在品質、速度與成本面向上有更大彈性。
- 適用生產環境的 API 驗證：使用標準的 Bearer 權杖驗證與明確的 API 版本標頭，以便受控整合。
- 支援直式與橫式輸出：Runway 文件列出支援模型家族在橫向與直向生成模式下的輸出尺寸。
- 相容參考影像工作流程：API 以影像參考為核心設計，Runway 提供輸入尺寸建議以協助維持生成品質。
- 可延展的創作管線適配：Runway 的更廣平台包含關鍵影格、擴展與其他生成模式等相關影片生成工作流程，使 image-to-video 可作為更大型創作管線中的一個階段。
如何存取與整合 runwayml-image-to-video
步驟 1：註冊並取得 API 金鑰
開始前，請在 CometAPI 註冊，並從儀表板產生你的 API 金鑰。取得金鑰後，妥善保存，並在所有請求的 Authorization 標頭中使用它。
步驟 2：向 runwayml-image-to-video API 發送請求
透過 CometAPI 使用 Runway 的官方 API 格式。端點為 POST /runwayml/v1/image_to_video。請包含 X-Runway-Version 標頭。
curl https://api.cometapi.com/runwayml/v1/image_to_video \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $COMETAPI_API_KEY" \
-H "X-Runway-Version: 2024-11-06" \
-d '{
"model": "gen4_aleph",
"promptText": "Your prompt here."
}'
步驟 3：擷取並驗證結果
API 會返回包含任務 ID 的任務物件。輪詢 GET /runwayml/v1/tasks/{task_id} 以檢查生成狀態，然後從已完成的任務回應中擷取輸出 URL。