影片轉影片 API
用 GoEnhance 影片轉影片 API 把影片風格化能力做進你的產品。先取得一個目前可用的模型 ID,提交一支 HTTPS 來源影片,選好長度與該模型支援的控制項,再取回非同步結果。本頁介紹的是 GoEnhance 自有的 API,不代表與任何第三方風格品牌或模型品牌有從屬關係。
建立 API Key
為 API 工作流程打造的影片風格化
每次送出轉換請求前,先確認該模型支援哪些控制項。
影片轉影片 API 功能
來源影片
把 <code>reference_video_url</code> 傳成公開可存取的 HTTPS MP4 或 MOV 檔案。目前文件列出的檔案大小上限是 50 MB。
模型與長度
傳入風格清單端點回傳的數字 <code>model</code> 值,以及必填的長度。文件列出的範圍是 3–30 秒。
提示詞與影響權重
對於支援的 V2 風格,可以使用選填的提示詞,並用 <code>video_refer</code> 把重心調向提示詞、居中平衡或來源影片。
主體保留
支援此功能的請求可以保留偵測到的人物或自訂主體、單獨去背取出主體,或把主體放在指定的純色背景上。
解析度
文件中 V5 的解析度選項是 <code>540p</code> 與 <code>720p</code>,其中 720p 是文件標明的預設值。
非同步交付
保存回傳的 <code>img_uuid</code>,接著輪詢工作詳情端點,或提供一個公開可存取的 HTTPS 回呼網址來接收狀態變更。
以帳戶內的即時價格為準,不要採信沒有依據的統一定價說法。
影片轉影片 API 價格參考
沒有統一公布的固定費率
目前公開的影片轉影片端點文件,並未公布一個適用於所有風格與所有請求的固定價格。
查看目前的 GoEnhance API 價格
在估算正式環境支出之前,先到你的 GoEnhance 帳戶或目前的價格頁面,確認所用模型的實際點數扣抵。
依可用的請求組合編列預算
先確定可用的模型,以及它支援的長度、解析度與轉換控制項,再估算成本;不要假設所有風格都套用同一套計費規則。
三個步驟串接 GoEnhance API
1
1. 探索與驗證
在伺服器端建立 API Key,呼叫風格清單端點,選定一個目前可用的數字模型 ID,並驗證來源影片的網址、檔案類型、大小與請求長度。
2
2. 送出轉換工作
帶上 Bearer 驗證,向
https://api.goenhance.ai/api/v1/video2video/generate 發出 POST 請求,附上必填的 model、duration 與 reference_video_url 欄位。只加入所選模型支援的控制項。 3
3. 處理非同步工作
同時檢查 HTTP 回應與 JSON 裡的
code/msg,保存 data.img_uuid,接著輪詢 GET /api/v1/jobs/detail,或處理具冪等性的回呼事件,直到工作成功或失敗。在需要可重複執行的伺服器端編排時,採用模型驅動的風格化。
影片轉影片 API 應用情境
動畫與插畫風格
把已取得授權的素材重新風格化為動畫、插畫、水墨、黏土、像素或其他目前可用的視覺呈現。
行銷素材的多種版本
用同一段動態素材產出多個不同的視覺方向,並把每個結果送進審核流程。
音樂與演出視覺
為短演出片段套上一致的視覺處理,同時保留原本的動作與節奏。
產品動態概念稿
在敲定最終製作方向之前,先用既有的產品素材試出風格化的動態方案。
角色與主體風格化
當流程需要把畫面主角或自訂主體與背景分開處理時,使用模型支援的主體控制項。
自動化創意流水線
把上傳、驗證、工作追蹤、回呼、審核、儲存與交付串成一條可追溯的後端流程。
關於端點、來源檔案、價格、控制項與非同步完成的解答。


