面向生產流程的影片換臉 API
透過 GoEnhance API 為你的影片流程加入需授權的換臉能力。送出目標影片、來源人臉圖片、輸出設定與一段時間區間；接著保存回傳的工作 ID，再去取得非同步結果。
取得 API 存取權
職責清楚的影片換臉 API 契約
圍繞文件中的請求、工作與結果契約來打造。
正式環境真正要緊的能力
以 Bearer 驗證的請求
把 GoEnhance API Key 保存在你自己的伺服器上，透過 Authorization 標頭送出。切勿在瀏覽器程式碼中暴露正式環境的憑證。
明確的素材角色
<code>reference_video</code> 用於目標片段，<code>reference_img</code> 用於要移轉過去的人臉，避免常見的參數順序放反問題。
有明確上限的來源素材
送出前先確認素材可以正常存取。現行端點文件記載的上限是影片 200 MB、圖片 5 MB。
帶時間範圍的轉換區段
<code>start_time</code> 與 <code>end_time</code> 的取值範圍是 0 到 120 秒，並且要驗證所選區間對來源片段而言確實有意義。
輸出與強化設定
<code>upscaler</code> 選 1 輸出 720p，選 2 輸出僅限 VIP 的 1080p；只有流程確實需要時才開啟 <code>enhance_face</code>。
帶型別的非同步結果
保存 <code>img_uuid</code>，處理好所有終止狀態，依 <code>type</code> 區分結果項目，並在暫時連結過期前把成功的產物複製保存下來。
以即時計費頁面與帳戶餘額為準。
不必靠猜的影片換臉 API 價格
查詢即時的影片換臉 API 價格
端點文件只給出費用倍率，並未給出固定的基礎單價。在做成本預估之前，請先到 GoEnhance 計費頁面確認目前的基礎收費。
把選用項目的倍率算進去
現行文件把 1080p 輸出與人臉強化標記為 1.5x 價格的選項，但沒有說明多個選項合併時如何計算，所以不要憑猜測，要以實際收費為準。
監控點數與預算
用 <code>GET /api/v1/user/tokens</code> 讀取 <code>data.count</code>，再圍繞你目前的 GoEnhance API 價格加上各租戶的額度限制、工作帳目記錄與警示。
三步串接 GoEnhance API
1
1. 驗證授權與素材
確認已取得當事人同意與使用權，核實兩個 URL 都能存取，依文件執行容量與時間上限，並在送出前拒絕不支援或語意不清的輸入。
2
2. 建立並保存工作
把必填的素材、時間範圍與輸出設定 POST 到
/api/v1/videofaceswap/generate；先檢查 HTTP 狀態與回應內容中的成功標記，再保存 data.img_uuid。 3
3. 追蹤、驗收並保存產物
以退避方式輪詢，或驗證回呼是否送達；依終止狀態與結果型別分支處理；檢查換臉結果在人物一致性與影格連貫性上是否合格，再把通過審核的產物移入長期儲存。
把當事人同意、資訊揭露與存取控制視為產品需求，而不是可有可無的說明文案。
實用且以授權為前提的應用情境
已取得授權的行銷素材變體
為已明確授權使用其肖像的藝人、品牌大使或客戶製作經過核可的影片變體。
影視前期預覽
在正式製作前先試選角或驗證場景連貫性，同時在流程中保留人工審核與權利授權的環節。
在地化創意製作
把已核可的素材改製成各地區的行銷版本，同時保留可追溯的素材授權、揭露說明與審核紀錄。
使用者主動選用的娛樂工具
支援那些由使用者自行提供目標片段與來源人像、並清楚知道結果是合成內容的體驗。
受控管的內部原型
用來評估構圖與創意方向，但不得把生成的畫面當成真實事件或真人代言來呈現。
帶審核機制的媒體應用
把換臉能力與存取控制、濫用檢舉、保存期限、來源溯源紀錄與核准關卡結合起來。
關於串接、價格、工作處理與負責任使用的實用解答。