프로덕션 워크플로를 위한 영상 페이스 스왑 API
GoEnhance API로 허가를 전제로 한 얼굴 교체 기능을 영상 파이프라인에 추가합니다. 대상 영상, 원본 얼굴 이미지, 출력 설정, 시간 구간을 전송한 다음 반환된 작업 ID를 저장하고 비동기 결과를 받아 옵니다.
API 사용 시작하기
역할이 명확한 영상 페이스 스왑 API 계약
구간이 지정된 영상 요청 준비하기
대상 클립은 reference_video로, 얼굴 이미지는 reference_img로 보냅니다. 현재 레퍼런스에는 최대 용량이 각각 200 MB와 5 MB로 명시되어 있으며, start_time, end_time, upscaler 필드도 필수입니다.
완료 결과를 비동기로 받아 오기
전송에 성공하면 data.img_uuid가 반환됩니다. GET /api/v1/jobs/detail을 폴링하거나 공개된 HTTPS 콜백을 지정하고, pending, processing, success, failed 상태를 모두 처리한 뒤 최종 영상을 저장하기 전에 타입이 지정된 결과 항목을 확인합니다.
문서화된 요청, 작업, 결과 계약을 중심으로 설계하십시오.
운영 환경에서 실제로 중요한 기능
Bearer 인증 요청
GoEnhance API 키는 서버에 보관하고 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. 작업 생성과 저장
필수 미디어, 시간 범위, 출력 설정을
/api/v1/videofaceswap/generate로 POST하고, HTTP 상태와 응답 본문의 성공 여부를 모두 확인한 다음 data.img_uuid를 저장합니다. 3
3. 추적, 검수, 결과 보관
백오프를 적용해 폴링하거나 콜백 수신을 검증하고, 종료 상태와 결과 타입에 따라 분기하며, 인물 동일성과 프레임 일관성을 검수한 뒤 승인된 결과물을 영구 저장소로 옮깁니다.
동의, 고지, 접근 제어는 선택적인 안내 문구가 아니라 제품 요구사항으로 다루십시오.
허가를 전제로 한 유용한 활용 사례
동의를 받은 캠페인 변형물
초상 사용을 명시적으로 허락한 모델, 앰배서더, 고객을 위해 승인된 영상 변형물을 제작합니다.
영상 프리비주얼라이제이션
최종 제작 전에 캐스팅이나 장면 연결을 시험해 봅니다. 이때도 사람의 검수와 권리 확보 절차는 워크플로에 그대로 유지합니다.
현지화 크리에이티브 제작
승인된 영상을 지역별 캠페인용으로 각색하면서 원본 사용 허가, 고지, 검수 기록을 추적 가능한 형태로 남깁니다.
옵트인 방식 엔터테인먼트 도구
사용자가 직접 대상 클립과 원본 인물 사진을 제공하고 결과물이 합성이라는 점을 이해하는 서비스에 활용합니다.
통제된 사내 프로토타입
구도와 콘셉트 방향을 검토하는 용도로만 사용하며, 생성된 영상을 실제 사건이나 실제 추천인 것처럼 제시하지 않습니다.
검수 체계를 갖춘 미디어 애플리케이션
페이스 스왑 기능을 접근 제어, 오남용 신고, 보관 기한, 출처 기록, 승인 게이트와 함께 운영합니다.
연동, 가격, 작업 처리, 책임 있는 사용에 대한 실용적인 답변입니다.