Video to Video API
GoEnhance video to video API로 영상 리스타일 기능을 제품에 넣을 수 있습니다. 현재 사용 가능한 모델 ID를 조회하고, HTTPS 원본 영상을 제출한 뒤, 길이와 해당 모델이 지원하는 제어 옵션을 고르고 비동기 결과를 받아 갑니다. 이 페이지는 GoEnhance 자체 API를 설명하며, 제3자 스타일 브랜드나 모델 브랜드와의 제휴를 의미하지 않습니다.
API 키 만들기
API 워크플로를 위한 영상 리스타일
런타임에 스타일 조회
GET /api/v1/video2video/modellist를 호출하고, 반환된 항목의 숫자 value를 생성 요청의 model로 사용합니다. 런타임 조회를 쓰면 애플리케이션이 현재 제공되는 카탈로그를 계속 따라갈 수 있습니다.
변환 제어하기
원본 영상과 함께 모델, 길이를 제출합니다. 선택한 모델에 따라 선택적 제어 옵션으로 프롬프트 반영 정도, 원본 영상 영향력, 피사체 유지, 배경 처리, 시드, 해상도, 콜백 전달을 조정할 수 있습니다.
변환 요청을 보내기 전에 모델별 제어 옵션을 먼저 확인합니다.
Video to Video API 기능
원본 영상
<code>reference_video_url</code>에는 공개 HTTPS MP4 또는 MOV 파일을 지정합니다. 현재 문서에 명시된 최대 파일 크기는 50 MB입니다.
모델과 길이
스타일 목록 엔드포인트가 반환한 숫자 <code>model</code> 값과 필수 항목인 길이를 함께 보냅니다. 문서에 명시된 범위는 3~30초입니다.
프롬프트와 반영 비중
지원되는 V2 스타일에서는 선택적 프롬프트와 <code>video_refer</code>로 프롬프트 쪽, 중간, 원본 영상 쪽 중 어디에 비중을 둘지 조절합니다.
피사체 유지
지원되는 요청에서는 감지된 인물이나 사용자 지정 피사체를 유지하고, 주요 피사체만 분리하거나, 지정한 단색 배경 위에 올릴 수 있습니다.
해상도
문서에 나온 V5 해상도 옵션은 <code>540p</code>와 <code>720p</code>이며, 기본값은 720p로 명시되어 있습니다.
비동기 전달
반환된 <code>img_uuid</code>를 저장한 뒤 작업 상세 엔드포인트를 폴링하거나, 상태 변경을 받을 공개 HTTPS 콜백 URL을 지정합니다.
근거 없는 단일 가격 대신 계정의 실시간 가격을 기준으로 삼으십시오.
Video to Video API 가격 기준
공개된 단일 정액 요금은 없습니다
현재 공개된 video to video 엔드포인트 문서에는 모든 스타일과 모든 요청에 적용되는 고정 가격이 나와 있지 않습니다.
현재 GoEnhance API 가격 확인
운영 비용을 추정하기 전에, 사용할 모델의 현재 토큰 차감량을 GoEnhance 계정이나 최신 가격 페이지에서 확인합니다.
유효한 요청 구성을 정한 뒤 예산 산정
사용 가능한 모델과 그 모델이 지원하는 길이, 해상도, 변환 제어 옵션을 정한 다음에 비용을 계산합니다. 모든 스타일이 같은 과금 규칙을 따른다고 가정하지 마십시오.
세 단계로 GoEnhance API 연동하기
1
1. 조회와 검증
서버 측에서 API 키를 만들고 스타일 목록 엔드포인트를 호출해 현재 유효한 숫자 모델 ID를 고른 뒤, 원본 영상 URL과 파일 형식, 크기, 요청 길이를 검증합니다.
2
2. 변환 요청 제출
Bearer 인증과 함께
https://api.goenhance.ai/api/v1/video2video/generate로 POST 요청을 보내고 필수 항목인 model, duration, reference_video_url를 담습니다. 선택한 모델이 지원하는 제어 옵션만 추가하십시오. 3
3. 비동기 작업 마무리
HTTP 응답과 JSON의
code/msg를 모두 확인하고 data.img_uuid를 저장한 뒤, GET /api/v1/jobs/detail를 폴링하거나 멱등한 콜백 이벤트를 처리해 성공 또는 실패까지 추적합니다.반복 가능한 서버 측 오케스트레이션이 중요한 곳에 모델 기반 리스타일을 적용하십시오.
Video to Video API 활용 사례
애니메이션과 일러스트 스타일
권리를 확보한 소스를 애니메이션, 일러스트, 수묵, 클레이, 픽셀 등 현재 제공되는 표현으로 다시 스타일링합니다.
캠페인 변형안
하나의 원본 영상에서 여러 시각 방향을 만들고, 각 결과를 검수 워크플로로 넘깁니다.
음악과 공연 비주얼
짧은 공연 클립에 일관된 스타일을 적용하면서 원래의 움직임과 타이밍은 그대로 살립니다.
제품 모션 콘셉트
최종 제작 방향을 확정하기 전에 기존 제품 영상으로 양식화한 모션 시안을 먼저 검토합니다.
캐릭터와 피사체 리스타일
주요 인물이나 사용자 지정 피사체를 배경과 다르게 처리해야 하는 워크플로에서는 모델이 지원하는 피사체 제어 옵션을 사용합니다.
자동화된 크리에이티브 파이프라인
업로드, 검증, 작업 추적, 콜백, 모더레이션, 저장, 전달을 추적 가능한 백엔드 흐름으로 연결합니다.
엔드포인트, 원본 파일, 가격, 제어 옵션, 비동기 완료에 대한 답변입니다.