프로덕션 워크플로우를 위한 이미지 얼굴 교체 API
GoEnhance API를 통해 이미지 파이프라인에 동의 기반 얼굴 교체 기능을 추가하세요. 대상 이미지와 소스 얼굴을 제출하고, 반환된 작업 ID를 저장한 다음, 결과가 최종 상태에 도달할 때까지 폴링하거나 콜백을 받으세요.
API 액세스 권한 받기
집중적인 이미지 얼굴 교체 API 계약
문서화된 요청, 작업 및 결과 계약을 중심으로 구축하세요.
프로덕션에서 중요한 기능
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 계정 가격 정책에 따라 청구된 활동을 조정하십시오.
세 단계로 GoEnhance API 통합하기
1
1. 동의 및 입력값 검증
두 얼굴을 사용할 권한이 있는지 확인하고, HTTPS 액세스를 검증하며, 문서화된 파일 크기 제한을 적용하고, 제출 전에 지원되지 않거나 모호한 에셋을 거부하십시오.
2
2. 작업 생성 및 유지
두 이미지 URL을
/api/v1/imagefaceswap/generate로 POST하고, HTTP 및 응답 수준의 성공 여부를 확인한 뒤 반환된 img_uuid를 저장하십시오. 3
3. 결과 확인 및 저장
백오프를 사용하여 폴링하거나 콜백 전달을 확인하고, 최종 상태 및 결과 유형에 따라 분기한 다음, 임시 링크가 만료되기 전에 성공적인 출력물을 영구 저장소로 이동하십시오.
동의, 공개 및 액세스 제어를 선택 사항이 아닌 제품 요구 사항으로 취급하십시오.
유용하고 권한 기반인 사용 사례
동의 기반 캠페인 개인화
이미지 사용을 명시적으로 승인한 인재, 앰배서더 또는 고객을 위해 승인된 크리에이티브 변형을 생성하십시오.
영화 및 프리비주얼라이제이션
최종 검토 및 권리 정리를 제작 과정에 유지하면서 내부 컨셉 프레임이나 캐스팅 미리보기를 생성하십시오.
현지화된 크리에이티브 워크플로우
추적 가능한 소스 권한과 인간의 검토를 유지하면서 지역 캠페인에 맞게 승인된 시각적 에셋을 조정하십시오.
아바타 및 프로필 경험
사용자가 대상 이미지와 소스 얼굴을 모두 인지하고 제공하는 옵트인 아바타 실험을 지원하십시오.
크리에이티브 프로토타이핑
합성 출력물을 실제 이벤트인 것처럼 제시하지 않으면서, 최종 사진 촬영을 의뢰하기 전에 레이아웃과 시각적 방향을 테스트하십시오.
중재된 미디어 도구
동의 확인, 남용 신고, 보존 규칙 및 생성 단계의 검토 게이트를 갖춘 제어된 애플리케이션에 페이스 스왑을 추가하십시오.
통합, 가격 책정, 작업 처리 및 책임 있는 사용에 대한 실용적인 답변입니다.


