AI 참조 기반 동영상 생성 API

텍스트 프롬프트와 참조 자료로 새로운 동영상을 생성하는 API입니다. 참조 자료는 주로 이미지이며, 일부 모델은 동영상이나 오디오도 지원합니다. 참조는 피사체, 외형, 스타일을 정하고 프롬프트는 일어나는 일을 설명합니다. 결과물은 기존 클립의 편집이 아니라 새로 생성된 장면입니다.

이미지-비디오는 지정한 이미지를 움직이게 하며, 보통 그 이미지를 첫 프레임(경우에 따라 마지막 프레임)으로 사용합니다. 참조 기반 생성은 이미지를 인물, 사물, 스타일의 단서로 사용하고 모델이 새로운 구도를 만듭니다. 시작 프레임이 이미지와 정확히 같아야 한다면 이미지-비디오를 선택하세요.

비디오-비디오는 기존 영상을 원본으로 삼아 편집, 연장, 변환합니다. 참조 기반 생성에서 참조 동영상은 새로 생성되는 클립의 동작, 카메라, 스타일을 안내하는 용도로만 쓰입니다. 기존 클립의 내용을 유지하면서 수정하려면 비디오-비디오 엔드포인트를 비교하세요.

모델에 따라 몇 장부터 멀티모달 엔드포인트의 수십 장까지 다르며, 참조 동영상을 함께 보내면 이미지 한도가 줄어드는 모델도 있습니다. 업로드 흐름을 만들기 전에 문서에서 개수, 형식, 파일 크기, 화면 비율 요건을 확인하세요.

일부 모델은 멀티모달 참조를 지원해 이미지로 외형을, 동영상으로 동작이나 카메라를, 오디오로 소리나 리듬을 안내합니다. 참조 이미지만 받는 모델도 있습니다. 오디오를 보낼 때 시각 참조를 최소 하나 요구하거나 참조 동영상의 길이와 해상도를 제한하는 엔드포인트도 있습니다.

대개 같은 요청에서는 함께 쓸 수 없습니다. 많은 모델에서 프레임 이미지 필드와 참조 필드는 상호 배타적이며, 둘 다 보내면 요청이 거부됩니다. 제출 전에 프레임 중심(이미지-비디오)인지 참조 중심인지 결정하세요.

피사체가 선명하고 조명이 충분하며 가려지지 않은 참조를 사용하고, 반드시 유지해야 할 요소에 집중하세요. 프롬프트에서 참조 피사체를 명확히 지칭하고, 서로 충돌하는 참조를 피하며, 짧은 클립으로 먼저 테스트하세요. 일관성은 모델마다 다르므로 자체 자료로 결과를 비교하세요.

그럴 수 있습니다. 일부 모델은 참조를 사용할 때 최대 해상도를 제한하거나, 화면 비율을 자동(adaptive)으로 기본 설정하거나, 길이를 고정합니다. 유효성 검사 실패를 피하려면 선택한 엔드포인트의 파라미터 규칙을 확인하세요.

주로 출력 길이와 해상도로 결정됩니다. 모델에 따라 참조 동영상 길이가 과금되거나, 추가 참조 이미지에 비용이 붙거나, 무료 한도를 넘는 참조 토큰이 과금될 수 있습니다. 선택한 모델의 최신 가격 설명을 확인하세요.

모델, 프롬프트, 참조 자료 URL을 PoYo 생성 엔드포인트에 보내고, 반환된 task_id를 저장한 뒤 상태 조회나 webhook으로 결과를 받습니다. 참조 URL이 공개적으로 접근 가능한지 확인하고, 비교를 위해 참조 세트를 작업 기록과 함께 보관하세요.