img_uuid를 저장하고 폴링 또는 HTTPS 콜백으로 결과를 받습니다.제작 자동화를 위한 AI 비디오 이펙트 API
독립적인 GoEnhance API로 AI 비디오 이펙트를 사용합니다. 사용 가능한 템플릿을 조회하고, 권리를 확보한 참조 이미지와 이펙트 ID를 전송한 뒤, 반환된
API 키 만들기
AI 비디오 이펙트 API의 기능
사용 가능한 이펙트 조회
Bearer 인증으로 GET /api/v1/videoeffect/list를 호출해 현재 이펙트 ID, 이름, 미리보기 URL을 가져옵니다. 오래된 목록을 코드에 하드코딩하지 마십시오.
작업 전송과 추적
공개 접근이 가능한 reference_img와 유효한 effect_id를 /api/v1/videoeffect/generate로 POST한 뒤, 반환된 img_uuid를 상태 확인용으로 저장합니다.
작업을 생성하기 전에 인증 정보, 미디어 접근성, 템플릿 식별자, 콜백 설정을 확인합니다.
AI 비디오 이펙트 API 요청 필수 사항
Bearer 인증
GoEnhance API 키는 <code>Authorization</code> 헤더로 전송하고 서버에만 보관하며, 클라이언트 코드에는 절대 두지 마십시오.
템플릿 조회
제품에서 이펙트 선택지를 노출하기 전에 <code>GET /api/v1/videoeffect/list</code>로 현재 카탈로그를 가져옵니다.
참조 이미지
<code>reference_img</code>에는 공개 접근이 가능한 HTTPS 이미지 URL을 넣고, 본인이 소유하거나 처리 권한을 확보한 미디어만 사용하십시오.
이펙트 식별자
선택한 템플릿의 정확한 <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. 전송하고 저장하기
reference_img, effect_id, 선택적 콜백 URL을 POST한 다음 응답의 data.img_uuid를 저장합니다. 3
3. 최종 결과 받기
작업이 success 또는 failed에 도달할 때까지
GET /api/v1/jobs/detail?img_uuid=...를 폴링하거나 콜백 본문을 멱등하게 처리합니다.직접 보유하거나 변형 허가를 받은 콘텐츠를 중심으로 반복 가능한 이펙트 워크플로를 구축합니다.
AI 비디오 이펙트 API 활용 사례
크리에이터 도구
사용자가 승인된 이펙트를 고르고, 권리를 확보한 정지 이미지를 애플리케이션에서 짧은 동적 소재로 바꿀 수 있게 합니다.
캠페인 변형
소재 권리, 모더레이션, 승인 절차는 자체 워크플로에 유지하면서 마케팅 시안의 이펙트 변형을 큐에 넣습니다.
UGC 파이프라인
업로드, 이펙트 선택, 비동기 처리, 결과 전달을 추적 가능한 백엔드 파이프라인으로 연결합니다.
엔터테인먼트 경험
명확한 동의와 콘텐츠 정책 검사를 전제로, 사용자가 직접 선택해 쓰는 재미 요소와 테마 애니메이션 기능을 만듭니다.
대량 제작 운영
작업 ID를 저장하고 최종 결과를 독립적으로 처리하면, 타임아웃이 발생해도 중복 전송 없이 배치를 복구할 수 있습니다.
미디어 자동화
최종 응답을 검증한 뒤에만 완성된 영상을 저장, 검수, 모더레이션, 배포 시스템으로 전달합니다.
엔드포인트, 가격, 입력값, 비동기 전달, 프로덕션 안전장치에 대한 답변입니다.