本番ワークフロー向け画像フェイススワップAPI
GoEnhance APIを通じて、同意ベースの顔置換機能を画像パイプラインに追加します。ターゲット画像とソースとなる顔画像を送信し、返されたタスクIDを保存した後、結果が最終状態に達するまでポーリングするか、コールバックを受け取ります。
APIアクセスを取得
最適化された画像フェイススワップAPIコントラクト
必要な2つの画像を送信
reference_imgをターゲット画像として、source_imgを顔画像として送信します。どちらもHTTPS画像URLである必要があり、現在のAPIリファレンスでは各入力の最大サイズを5MBと定めています。
ブロッキングなしで完了を追跡
送信が成功するとimg_uuidが返されます。GET /api/v1/jobs/detailをクエリするか、公開されているHTTPSコールバックURLを提供し、保留中、処理中、成功、失敗の結果を明示的に処理してください。
文書化されたリクエスト、タスク、結果のコントラクトに基づいて構築します。
本番環境で重要な機能
Bearer認証によるリクエスト
GoEnhance APIキーはサーバー上で管理し、Authorizationヘッダーで送信してください。本番環境の認証情報をブラウザコードに決して公開しないでください。
ターゲットとソースの明確な役割
ターゲット構成には<code>reference_img</code>を、転送する顔には<code>source_img</code>を使用し、入力順序の間違いを防ぎます。
HTTPSアセットの検証
タスクを作成する前に、両方の画像URLがAPIからアクセス可能であり、規定の5MB制限内であることを確認してください。
非同期タスクID
返された<code>img_uuid</code>を保持し、ワーカー、再試行、コールバック、および顧客向けのステータス確認がすべて同じジョブを参照するようにします。
ポーリングまたはコールバック
バックオフを使用してジョブ詳細エンドポイントをポーリングするか、公開されているHTTPSエンドポイントでステータス変更のコールバックを受け取ります。
型指定された結果の処理
最初の項目が常に画像URLであると想定せず、<code>type</code>ごとに各結果エントリを検査し、期限切れになる出力は承認済みの独自のストレージにコピーしてください。
現在のアカウント料金と残高データを信頼できる唯一の情報源として使用します。
推測に頼らない画像フェイススワップAPIの料金設定
ライブ画像フェイススワップAPIの料金を確認
現在の公開エンドポイントリファレンスでは、画像ごとの固定トークンレートは公開されていません。架空の数値や古い数値に頼るのではなく、支出を予測する前にGoEnhanceの請求ページで実際の料金を確認してください。
トークン残高を監視
<code>GET /api/v1/user/tokens</code>を使用して<code>data.count</code>から利用可能な残高を読み取り、ジョブを送信する前に内部アラートをトリガーします。
アプリケーションレベルの予算を設定する
タスクの作成と最終結果を記録し、テナントごとに使用量を制限し、請求対象のアクティビティをGoEnhanceアカウントの料金と照合します。
3つのステップでGoEnhance APIを統合する
1
1. 同意と入力の検証
両方の顔を使用する許可があることを確認し、HTTPSアクセスを検証し、文書化されたファイルサイズ制限を適用し、送信前にサポートされていない、または曖昧なアセットを拒否します。
2
2. タスクの作成と永続化
2つの画像URLを
/api/v1/imagefaceswap/generateにPOSTし、HTTPおよびレスポンスレベルの両方で成功を確認し、返されたimg_uuidを保存します。 3
3. 結果の解決と保存
バックオフによるポーリングまたはコールバック配信の検証を行い、最終ステータスと結果タイプに基づいて分岐し、一時的なリンクが期限切れになる前に成功した出力を永続ストレージに移動します。
同意、開示、およびアクセス制御を、オプションのコピーではなく製品要件として扱います。
有用で許可に基づいたユースケース
同意に基づくキャンペーンのパーソナライズ
画像の利用を明示的に許可したタレント、アンバサダー、または顧客向けに、承認済みのクリエイティブバリエーションを生成します。
映画およびプリビジュアライゼーション
最終的なレビューと権利のクリアランスを制作プロセスに残したまま、内部コンセプトフレームやキャスティングプレビューを作成します。
ローカライズされたクリエイティブワークフロー
追跡可能なソース権限と人間によるレビューを保持しながら、地域キャンペーン向けに承認済みのビジュアルアセットを適応させます。
アバターおよびプロフィール体験
ユーザーがターゲット画像とソースとなる顔の両方を自発的に提供する、オプトイン型のアバター実験を強化します。
クリエイティブプロトタイピング
合成出力を本物のイベントとして提示することなく、最終的な撮影を依頼する前にレイアウトやビジュアルの方向性をテストします。
モデレートされたメディアツール
同意チェック、不正利用報告、保持ルール、および生成に関するレビューゲートを備えた制御されたアプリケーションにフェイススワップを追加します。
統合、料金、タスク処理、責任ある利用に関する実践的な回答。