runwayml-text-to-image 的技術規格
| 規格 | 詳細資訊 |
|---|---|
| CometAPI 上的模型 ID | runwayml-text-to-image |
| 上游提供方 | Runway |
| 主要能力 | 文字轉圖像生成，將自然語言提示轉換為 AI 生成的靜態圖像。 |
| 最接近的官方 Runway 模型系列 | Runway 的圖像生成 API 方案，以 gen4_image 及相關圖像模型為核心。CometAPI 透過平台識別符 runwayml-text-to-image 對外提供。 |
| 輸入類型 | 文字提示；在 Runway 更廣的圖像 API 堆疊中，亦可選用圖像參考，支援多模態的圖像生成/編輯工作流程。 |
| 輸出類型 | 生成的圖像。 |
| 存取方式 | 透過 Runway 的開發者平台與相容整合，以 API 方式存取。 |
| 驗證方式 | 在 Runway 的開發者設定流程中，使用 API key / API secret 進行驗證。 |
| SDK 可用性 | 透過 Runway 的 SDK 資源，提供面向 Node.js 與 Python 工作流程的官方 SDK 支援。 |
| 定價情境 | Runway 將 gen4_image 的圖像生成定價標示為每張 720p 圖像 5 點數或 1080p 圖像 8 點數；gen4_image_turbo 標示為每張 2 點數。CometAPI 的實際計費可能因平台而異。 |
| 典型使用情境 | 行銷視覺、概念藝術、分鏡腳本、產品模型圖、設計發想，以及其他創意圖像生成任務。此為根據 Runway 所述的圖像生成定位所做的推論。 |
什麼是 runwayml-text-to-image？
runwayml-text-to-image 是 CometAPI 用於存取由 Runway 驅動之文字轉圖像生成功能的平台識別符。根據 Runway 的官方 API 文件與產品資料，該底層能力旨在將自然語言提示轉換為生成圖像；Runway 目前的 API 模型陣容包含專用的圖像模型，例如 gen4_image 與 gen4_image_turbo。
在實務上，此類模型面向希望將高品質圖像創建嵌入至應用程式、內部工具、創意工作流程或面向使用者體驗的開發者與產品團隊。Runway 將其 API 定位為將生成式媒體整合到應用與產品中的開發者平台，其圖像 API 同時支援基於提示的生成，並在部分情況下支援以參考圖引導的工作流程，以獲得更可控的輸出。
由於 CometAPI 採用自有的正規化模型 ID 格式，即便 Runway 的原生文件使用 gen4_image 等特定上游模型名稱，透過 CometAPI 呼叫時仍應持續使用 runwayml-text-to-image。
runwayml-text-to-image 的主要功能
- 文字轉圖像生成：將自然語言提示轉換為 AI 生成的圖像，適用於創意、視覺與產品導向的工作流程。
- Runway 圖像模型支援：此能力對應 Runway 的專用圖像生成技術堆疊，尤其是
gen4_image，其在 API 模型目錄中被呈現為 Runway 的旗艦圖像模型。 - 參考感知的工作流程：Runway 的圖像 API 文件強調支援文字加圖像的參考模式，在上游模型支援的情況下，可對構圖、風格或主題引導進行更高程度的控制。
- 對開發者友善的 API 存取：Runway 提供完整文件的 API、設定指南與 SDK，以簡化整合至正式環境應用。
- 多種品質/成本選項：Runway 提供不同定價屬性的獨立圖像模型，包括
gen4_image與gen4_image_turbo，提供在輸出品質與生成成本之間的彈性。 - 創意產製用途：此模型適合發想、素材生成、視覺原型、概念探索與設計輔助等場景。此使用情境的定位係根據 Runway 圍繞應用與創意團隊之圖像生成產品定位所推斷。
如何存取並整合 runwayml-text-to-image
步驟 1：註冊取得 API Key
註冊 CometAPI，並在儀表板建立 API key。於進入正式環境前，請將金鑰安全地存放於環境變數或秘密管理工具中。
步驟 2：向 runwayml-text-to-image API 發送請求
透過 CometAPI 使用 Runway 的官方 API 格式。端點為 POST /runwayml/v1/text_to_image。請加入 X-Runway-Version 標頭。
curl https://api.cometapi.com/runwayml/v1/text_to_image \
-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。