기존 영상을 수정하면서 동작, 타이밍, 프레이밍, 주체는 모델이 그대로 유지하길 원할 때 Kling 4.0 동영상 편집을 사용하세요. 요청에는 무엇을 바꾸고 무엇을 유지할지가 드러나야 합니다. 새로운 생성에 영감을 주는 참조 동영상과 편집 대상인 소스 동영상은 서로 다른 워크플로입니다.
이 가이드는 PoYo의 Kling 4.0 API와 저장된 완료 예시 하나를 사용합니다. 눈 위를 걷는 붉은여우를 가을 숲으로 편집한 예시입니다. 이것은 장면 변경 예시이며, 모든 제품 교체나 정체성 유지 편집이 성공한다는 근거는 아닙니다.
소스와 편집 결과 비교해 보기
소스: 겨울 야생동물 샷. 기록된 작업 9DRXDJ5XGW41B9IW, 720p로 5초를 요청했으며 첫 프레임으로 생성했습니다. 기록된 청구 금액: 142.5 크레딧.
편집 결과: 가을 숲. 기록된 작업 84PEDOWZ40C5D7VM, 720p로 5초를 요청했으며 소스 동영상과 가을 참조 이미지를 사용했습니다. 기록된 청구 금액: 187 크레딧.
정확한 편집 요청과 샘플 메타데이터를 내려받으세요. 원본과 편집본을 직접 비교해 보면 여우의 무늬, 걸음걸이, 머리 움직임, 지면 접촉, 카메라 트래킹, 나뭇잎 경계가 모두 중요하다는 것을 알 수 있습니다. 필요한 동작이 흐트러졌다면 배경이 바뀐 것만으로는 충분하지 않습니다.
video_url로 편집 모드를 명시적으로 선택하기
아래의 축약 템플릿은 필드 구성을 보여 줍니다. 기록된 작업의 전체 프롬프트는 다운로드 파일에 들어 있습니다.
{
"model": "kling-4.0",
"input": {
"video_url": "https://storage.poyo.ai/blog/kling-4-0-series-20261024/fox-video-d0100387a0e0.mp4",
"reference_image_urls": ["https://storage.poyo.ai/blog/kling-4-0-series-20261024/autumn-reference-0773c88cbeb3.png"],
"prompt": "Edit @Video1 into the autumn woodland shown in @Image1. Replace snow with dry fallen leaves and distant conifers with silver birches. Preserve the same fox, its markings, proportions, walking and head movements, timing, framing and camera tracking. Match shadows and light to the new environment. Return one coherent live-action scene, not a montage or transition.",
"duration": 5,
"resolution": "720p"
}
}
소스는 @Video1, 이미지 참조는 @Image1로 지칭합니다. 이미지는 새로운 외형을 지정하고, 소스는 유지할 동작을 제공합니다. video_url은 생성 모드보다 우선해 편집 모드를 선택하므로, 동작 참조로 새 샷을 생성하려는 요청에는 이 필드를 넣지 마세요.
PoYo 편집 스키마가 허용하는 입력
소스의 실제 길이는 3~30초여야 합니다. 편집에는 prompt가 필수이며 720p 또는 1080p를 지원합니다. 참조 이미지와 이미지로 정의한 주체(subject)는 사용할 수 있지만, image_urls, reference_video_urls, 동영상으로 정의한 주체, multi_prompt, aspect_ratio는 거부됩니다.
지원하지 않는 필드를 끄려고 null이나 빈 값으로 보내지 마세요. 아예 생략해야 합니다. PoYo의 현재 편집 인터페이스는 소스 동영상 필드 하나만 허용합니다. 더 폭넓은 크리에이터 제품에 다중 동영상 워크플로가 있다고 해서 여기서 video_urls 배열을 임의로 만들어 쓰면 안 됩니다. 업데이트 사항은 최신 API 문서에서 확인하세요.
제약이 명확한 편집 프롬프트 작성법
지시문을 두 개의 명확한 문장으로 나누세요. 먼저 원하는 변경을 적습니다. 계절 바꾸기, 재킷 변경, 제품 교체 같은 것입니다. 그다음 유지할 구조를 적습니다. 주체의 정체성, 동작 타이밍, 카메라 움직임, 프레이밍, 건드리지 않을 객체입니다.
제품 교체에는 실루엣이 분명한 깔끔한 참조를 제공하고, 어떤 객체를 교체할지 적으세요. 손과 표면의 접촉, 움직이는 가림, 그림자, 반사를 확인하세요. 모델이 요청보다 더 많은 부분을 바꿀 수 있으므로, 승인 전에 샷 전체를 비교하고 브랜드 디테일을 검증하세요. 이 글의 여우 예시는 제품 교체의 성공률을 측정해 보여 주는 것이 아닙니다.
첫 테스트에서 캐릭터, 배경, 의상, 카메라, 대사를 한꺼번에 바꾸지 마세요. 편집이 실패했을 때 변경 범위가 작을수록 다음 진단이 더 유용해집니다.
소스 길이와 출력 길이로 비용 추정하기
편집에는 동영상 입력 가격이 적용됩니다. 현재 PoYo 공시 단가는 720p가 과금 초당 17 크레딧, 1080p가 25.5 크레딧입니다. 과금 초는 output + max(ceil(source duration), output)입니다.
소스가 정확히 5초이고 요청 출력도 5초라면 과금 시간은 10초로, 720p 기준 170 크레딧 / $0.85입니다. 실제 파일은 요청한 생성 길이보다 약간 길 수 있습니다. 저장된 가을 작업의 기록된 청구 금액 187 크레딧은 과금 11초에 해당합니다. 모든 “5초” 파일이 정확히 5초라고 가정하지 말고, 서버에서 측정한 소스 길이와 작업 기록을 사용하세요.
duration을 생략하면 PoYo는 소스 길이를 올림한 값을 출력 과금에 사용하며, 업스트림에는 duration을 생략한 채로 보냅니다. 소수점 길이 예시는 가격 가이드를 참고하세요.
게시 전에 검토하기
두 클립을 같은 지점끼리 비교한 다음 일반 속도로 재생해 보세요. 객체 정체성, 동작 연속성, 가장자리 깜박임, 텍스처 안정성, 의도하지 않은 콘텐츠를 확인합니다. 사운드트랙 전체는 별도로 들어 보세요. 화면이 유지되었다고 해서 오디오도 유지되었다는 뜻은 아닙니다.
참조를 활용한 새 생성은 Omni Reference 가이드를, 제출과 폴링은 API 튜토리얼을 참고하세요. 공식 크리에이터 가이드에는 추가 창작 워크플로가 소개되어 있으며, 플랫폼별 제공 여부에 따라 달라질 수 있습니다.