MCP API — 영상 제작

개요

MCP로 AI 영상 클립을 생성하고 최종 영상으로 합성하는 과정을 다룹니다. 영상 파이프라인은 비동기이며 create_clip과 compose_video 도구를 순차적으로 호출합니다.

create_clip

텍스트, 이미지, 또는 둘 다를 입력으로 받아 AI 영상 클립을 생성합니다. 반환값은 taskId이며 get_job_status로 폴링합니다.

모드

• text-to-video — 프롬프트만으로 생성. 기본 모델: veo3-fast
• image-to-video — 이미지 한 장을 영상으로 변환. 기본 모델: kling-v3-pro
• image-text-to-video — 이미지 + 모션 프롬프트. 기본 모델: kling-v3-pro

지원 모델

모델	길이	특징
veo3-fast	5~8초	T2V 빠른 버전, 오디오 자동 생성
veo3	5~8초	T2V 최고 품질, 오디오 자동 생성
kling-v3-pro	3~15초	I2V/IT2V, characterReferences + endImage 지원
kling-o3	3~15초	I2V/IT2V, 동일 기능
kling-v2.6-pro	5 or 10초	endImage 지원
ltx-2.3	6~20초 (짝수)	endImage 지원, 빠름, 오디오 미지원
seedance-2.0	4~15초	T2V/I2V/IT2V 전 모드, 오디오 자동 생성
seedance-2.0-fast	4~15초	빠른 버전, 동일 기능

비용

• 5초 — 2,500 코인
• 10초 — 5,000 코인
• 15초 — 7,500 코인

실패 시 자동 환불됩니다.

캐릭터 일관성

characterReferences로 동일 인물을 여러 씬에서 유지할 수 있습니다 (kling-v3-pro, kling-o3 전용). frontal_image_url 또는 assetId를 전달하세요.

씬 연속성 (멀티씬 체이닝)

이전 씬의 모션/카메라를 이어받으려면 previousClipTaskId, referenceVideoUrl, continueMotion, preserveCamera, preserveSceneLayout을 전달합니다.

compose_video

완료된 클립들을 최종 영상으로 합성합니다. Remotion 기반으로 트랜지션, 색보정, 브랜딩, BGM을 적용합니다.

주요 설정

• format — 16:9 / 9:16 / 4:3
• transition — crossfade, fade, slide-left/right, slide-up/down, wipe-left/right, clock-wipe, flip, none
• colorGrading — none / warm / cool / cinematic / vintage
• vignette, filmGrain — VFX 효과
• brand — 브랜드명 + 색상 (자막/아웃트로에 반영)

BGM 자동 믹싱

워크플로우 그래프에서 BGM 노드가 compose 노드에 연결되어 있으면 합성 시 자동으로 믹싱됩니다 (크로스페이드 루프 + 페이드 아웃 + 덕킹 기본 적용). 자세한 내용은 "오디오 / BGM" 섹션을 참고하세요.

비용

합성당 500 코인

예제: 30초 광고 영상

1. upload_asset 또는 generate_image로 캐릭터 assetId 확보
2. create_workflow로 workflowId 생성
3. create_clip × 3~6회 호출 (각 씬)
4. get_job_status 폴링으로 모든 클립 완료 대기
5. (선택) create_bgm으로 BGM 생성
6. compose_video로 최종 합성
7. get_job_status로 합성 완료 대기 → outputUrl 확인