img_uuid，接著以輪詢或 HTTPS 回呼取得結果。為自動化創作流程打造的 AI 影片特效 API
透過獨立的 GoEnhance API 使用 AI 影片特效。先列出可用的特效範本，再帶上特效 ID 送出一張已取得授權的參考圖，保存回傳的
建立 API Key
AI 影片特效 API 的功能
建立任務前，先確認憑證、素材存取權、範本識別碼與回呼設定都正確無誤。
AI 影片特效 API 請求要點
Bearer 驗證
在 <code>Authorization</code> 標頭中帶入 GoEnhance API Key，並且只放在伺服器端，絕不要寫進用戶端程式碼。
範本查詢
在產品中顯示特效選項之前，先用 <code>GET /api/v1/videoeffect/list</code> 取得目前的範本清單。
參考圖
在 <code>reference_img</code> 中提供可公開存取的 HTTPS 圖片網址，且只使用你擁有版權或已取得授權處理的素材。
特效識別碼
傳入所選範本正確的 <code>effect_id</code>；請用最新的清單回應來驗證，不要憑猜測拼湊識別碼。
選用的回呼
若希望把狀態通知送到公開的 HTTPS 端點，請填入 <code>custom_callback_url</code>。
非同步任務 ID
把送出成功後回應中的 <code>data.img_uuid</code> 保存下來，並與你內部的請求紀錄關聯起來。
請以即時的範本資料與文件為準，不要沿用臆測或過期的通用價格。
AI 影片特效 API 價格
價格因特效而異
AI 影片特效 API 的價格取決於所選範本以及 GoEnhance 目前的特效目錄。不要假設每個特效都是同一個固定費率。
查詢即時目錄
對於你打算執行的特效，請以範本清單 API 與 GoEnhance 最新文件為準。
送出前先估算成本
在把正式批次排入佇列之前，先確認所選的 <code>effect_id</code> 及其目前的計費細節，因為目錄條件可能會變動。
三步驟串接 AI 影片特效
1
1. 查詢清單並驗證
取得特效清單，選定正確的
effect_id，並確認你的 HTTPS 參考圖可以存取、且已取得處理授權。 2
2. 送出並保存
POST 送出
reference_img、effect_id 與選用的回呼網址，接著保存回應中的 data.img_uuid。 3
3. 取得最終結果
輪詢
GET /api/v1/jobs/detail?img_uuid=...，或以冪等方式處理回呼內容，直到任務進入 success 或 failed。圍繞你擁有版權、或已取得改作許可的內容，建立可重複使用的特效流程。
AI 影片特效 API 應用情境
創作者工具
讓使用者在你的應用程式中挑選已審核的特效，把已取得授權的靜態圖片變成短小的動態素材。
行銷素材變體
為行銷創意排入多種特效版本，同時把素材版權、內容審核與核准流程留在你自己的工作流程中。
UGC 流程
在一條可追蹤的後端流程中串起上傳、特效選擇、非同步處理與結果交付。
娛樂體驗
在明確取得同意並落實內容政策檢查的前提下，打造使用者自願啟用的趣味玩法與主題動畫功能。
批次創作維運
保存任務 ID 並獨立處理最終結果，讓批次在逾時後能夠復原，而不會重複送出。
媒體自動化
只有在驗證過最終回應之後，才把完成的影片送入儲存、複審、審核與發布系統。
關於端點、價格、輸入內容、非同步交付與正式環境防護措施的解答。