影片轉影片 API

用 GoEnhance 影片轉影片 API 把影片風格化能力做進你的產品。先取得一個目前可用的模型 ID,提交一支 HTTPS 來源影片,選好長度與該模型支援的控制項,再取回非同步結果。本頁介紹的是 GoEnhance 自有的 API,不代表與任何第三方風格品牌或模型品牌有從屬關係。
建立 API Key
具電影感的行駛車輛畫面,代表影片轉影片 API 的風格轉換

為 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

1. 探索與驗證

在伺服器端建立 API Key,呼叫風格清單端點,選定一個目前可用的數字模型 ID,並驗證來源影片的網址、檔案類型、大小與請求長度。
2. 送出轉換工作
2

2. 送出轉換工作

帶上 Bearer 驗證,向 https://api.goenhance.ai/api/v1/video2video/generate 發出 POST 請求,附上必填的 modeldurationreference_video_url 欄位。只加入所選模型支援的控制項。
3. 處理非同步工作
3

3. 處理非同步工作

同時檢查 HTTP 回應與 JSON 裡的 code/msg,保存 data.img_uuid,接著輪詢 GET /api/v1/jobs/detail,或處理具冪等性的回呼事件,直到工作成功或失敗。
在需要可重複執行的伺服器端編排時,採用模型驅動的風格化。

影片轉影片 API 應用情境

動畫與插畫風格

把已取得授權的素材重新風格化為動畫、插畫、水墨、黏土、像素或其他目前可用的視覺呈現。

行銷素材的多種版本

用同一段動態素材產出多個不同的視覺方向,並把每個結果送進審核流程。

音樂與演出視覺

為短演出片段套上一致的視覺處理,同時保留原本的動作與節奏。

產品動態概念稿

在敲定最終製作方向之前,先用既有的產品素材試出風格化的動態方案。

角色與主體風格化

當流程需要把畫面主角或自訂主體與背景分開處理時,使用模型支援的主體控制項。

自動化創意流水線

把上傳、驗證、工作追蹤、回呼、審核、儲存與交付串成一條可追溯的後端流程。
關於端點、來源檔案、價格、控制項與非同步完成的解答。

影片轉影片 API 常見問題

用影片轉影片 API 開始打造

影片轉影片 API:模型、價格與串接 | GoEnhance Open API