runway_video

runway-video 的技術規格

什麼是 runway-video？

runway-video 是 CometAPI 用於透過統一 API 存取 Runway 影片生成能力的平台識別符。根據 Runway 的官方 API 文件，Runway 提供多個影片模型，可從文字提示或圖片生成片段，並以任務為基礎的端點啟動生成，之後再擷取結果。

在實務上，runway-video 更適合被理解為一個通往 Runway 驅動的影片創作工作流程的閘道，而非單一獨立的基礎模型名稱。Runway 目前的 API 目錄包含多個具有不同輸入模式與定價層級的影片模型，例如支援文字或圖片轉影片的 gen4.5、支援圖片轉影片的 gen4_turbo，以及其他選項如 gen4_aleph、veo3、veo3.1、veo3.1_fast、gen3a_turbo。

這使得 runway-video 適用於創意原型設計、行銷內容生成、社群媒體短片製作、概念視覺化，以及需要自動化短篇影片合成的產品體驗等應用。由於底層 Runway API 使用非同步作業，整合時通常先提交生成請求，待處理完成後，再輪詢或擷取任務輸出。

runway-video 的主要功能

• 文字轉影片生成：Runway 支援在受支援的模型上，從自然語言提示生成影片，讓開發者可直接從描述產生片段。
• 圖片轉影片工作流程：多個 Runway 影片模型接受圖片輸入，使 runway-video 可用於為靜態圖片賦予動態或建立以參考為導向的影片生成管線。
• 多種底層模型選項：Runway API 暴露多個影片模型，具備不同能力與成本曲線，便於在品質、速度或預算之間取得平衡。
• 非同步任務處理：生成請求會建立任務，而非立即回傳最終媒體，適合需要佇列、重試與狀態檢查的生產系統。
• 暫時性素材上傳：Runway 提供上傳端點並回傳 runwayUri 參照，便於在後續生成請求中傳遞圖片、影片或音訊素材。
• 官方 SDK 支援：Runway 提供 Node.js 與 Python SDK，簡化驗證、請求構造與輸出擷取。
• 版本化 API 整合：請求需包含明確的 X-Runway-Version 標頭，有助於依據已知的 API 契約進行開發。
• 點數制計費：Runway 依每秒生成輸出所需點數計費，費率依所選底層模型而異。

如何存取並整合 runway-video

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

要存取 runway-video，請先建立帳號並在 CometAPI 儀表板產生 API 金鑰。登入後，複製你的 API 金鑰，並在生產環境中安全地儲存在環境變數或機密管理工具中。

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

使用你的 API 金鑰為發往 runway-video 的 CometAPI 端點的請求進行驗證。在請求主體中傳遞提示與任何受支援的輸入參數，並將模型指定為 runway-video。

curl -X POST "https://api.cometapi.com/v1/responses" \
  -H "Authorization: Bearer $COMETAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "runway-video",
    "input": "Create a cinematic video of a futuristic city at sunrise with slow camera movement."
  }'

步驟 3：擷取並驗證結果

提交後，檢視 API 回應中針對 runway-video 回傳的生成輸出、任務識別碼或結果負載。若為非同步，請輪詢相關的 CometAPI 端點直到處理完成，接著在將其用於你的應用程式前，先驗證回傳的影片 URL、中繼資料與內容。