用於生產工作流程的圖像換臉 API
透過 GoEnhance API 將基於同意原則的臉部替換功能加入圖像處理流程。提交目標圖像與來源臉部圖像,儲存回傳的任務 ID,然後進行輪詢或接收回調,直到結果達到最終狀態。
取得 API 存取權限
專注的圖像換臉 API 合約
圍繞著已記錄的請求、任務與結果合約進行建構。
生產環境中的關鍵功能
Bearer 驗證請求
請將 GoEnhance API 金鑰保留在您的伺服器上,並透過 Authorization 標頭發送。切勿在瀏覽器程式碼中暴露生產環境憑證。
明確的目標與來源角色
使用 <code>reference_img</code> 進行目標合成,並使用 <code>source_img</code> 進行臉部轉換,以防止常見的輸入順序錯誤。
HTTPS 資產驗證
在建立任務前,請驗證兩個圖像網址皆可被 API 存取,且維持在文件規定的 5 MB 上限內。
非同步任務 ID
請持久化儲存回傳的 <code>img_uuid</code>,以便工作執行緒、重試機制、回調以及客戶端狀態檢查都能參照同一個作業。
輪詢或回調
使用退避機制輪詢作業詳細資訊端點,或在可公開存取的 HTTPS 端點接收狀態變更回調。
型別化結果處理
請依據 <code>type</code> 檢查每個結果項目,而非假設第一個項目永遠是圖像網址,並將即將過期的輸出內容複製到您自己的核准儲存空間中。
使用當前的帳戶定價與餘額數據作為真實性來源。
無需猜測的圖像換臉 API 定價
查看即時圖像換臉 API 定價
目前的公開端點參考並未發布固定的每張圖像代幣費率。在預估支出前,請先在 GoEnhance 計費頁面確認即時收費,切勿依賴虛構或過時的數字。
監控代幣餘額
使用 <code>GET /api/v1/user/tokens</code> 從 <code>data.count</code> 讀取可用餘額,並在提交任務前觸發內部警報。
設定應用程式層級的預算
記錄任務建立與最終結果,按租戶限制使用量,並根據您的 GoEnhance 帳戶定價核對計費活動。
透過三個步驟整合 GoEnhance API
1
1. 驗證同意與輸入
確認您已獲得使用兩張臉孔的許可,驗證 HTTPS 存取權,強制執行已記錄的檔案大小限制,並在提交前拒絕不支援或模糊的資產。
2
2. 建立並保存任務
將兩張圖像的 URL 以 POST 方式傳送至
/api/v1/imagefaceswap/generate,檢查 HTTP 與回應層級的成功狀態,並儲存回傳的 img_uuid。 3
3. 解析並儲存結果
使用輪詢並配合退避機制或驗證回調傳遞,根據終端狀態與結果類型進行分支處理,然後在臨時連結過期前將成功的輸出移至持久性儲存空間。
將同意、揭露與存取控制視為產品需求,而非選填的文案。
實用且基於許可的使用案例
經同意的行銷活動個人化
為已明確授權使用圖像的藝人、代言人或客戶生成經核准的創意變體。
影片與預覽視覺化
在製作過程中建立內部概念影格或選角預覽,同時保留最終審核與權利清單。
在地化創意工作流程
調整經核准的視覺資產以適應區域性行銷活動,同時保留可追溯的來源權限與人工審核。
虛擬人像與個人檔案體驗
支援使用者主動參與的虛擬人像實驗,讓使用者知情並提供目標圖像與來源臉孔。
創意原型設計
在委託最終攝影前測試版面配置與視覺方向,且不將合成輸出呈現為真實事件。
受控媒體工具
將換臉功能加入受控應用程式中,並包含同意檢查、濫用報告、保留規則以及生成過程中的審核閘道。
關於整合、定價、任務處理與負責任使用的實用解答。


