비디오 만들기
만들기 화면의 비디오 모드, 첫·끝 프레임과 레퍼런스 첨부, MCP·공개 API로 영상을 만드는 방법입니다.비디오 만들기란
글로 장면과 움직임을 설명하거나, 이미지를 첫 프레임으로 줘서 짧은 영상을 만들어 줍니다. 만든 영상은 생성 내역과 내 에셋에 쌓이고, 캔버스와 에디터에서 이어 쓸 수 있습니다. 후보마다 체리를 씁니다.
이미지와 비디오는 같은 만들기 화면을 씁니다. 입력창의 모델과 옵션, 첨부 칸만 다릅니다. 이미지는 이미지 만들기를 보세요.
화면에서 만들기
비디오 프로젝트의 만들기 탭(
/video/<프로젝트 id>/create)을 엽니다. 입력창 위의 생성 종류에서 비디오를 고릅니다. 마지막으로 쓴 종류는 계정에 기억되어 다음에 열 때 먼저 선택됩니다.- 모델 선택을 눌러 모델을 고릅니다. 모델마다 한 줄 설명과 함께 길이 범위(예: 4~15초), 해상도 범위, 소리 지원, N 체리부터가 보입니다. 가격을 확정할 수 없는 모델은 가격 자리에 이유가 나오지만, 고르는 것은 됩니다. 모델 목록은 모델 목록에 있습니다.
- 입력창에 만들고 싶은 장면과 움직임을 적습니다. 안내 문구는 "만들고 싶은 장면과 움직임을 설명해 주세요"입니다.
- 모델이 요구하거나 받는 첨부가 있으면 입력창 아래 칸에 넣습니다. 아래 첨부 칸 절을 보세요.
- 옵션을 고릅니다. 아래 옵션 절을 보세요.
- 생성 버튼을 누릅니다. 버튼 아래에 예상 체리가 나옵니다.
- 확인 창 "영상을 만들까요?"에서 이번에 드는 체리, 보유 체리, 이번 시간 영상 접수 N/한도회를 확인하고 만들기를 누릅니다. 취소를 누르면 입력이 그대로 남습니다.
체리가 모자라면 확인 창에 부족한 금액이 나오고 만들기가 잠깁니다. 시도 중 부족이 확인되면 "체리가 부족해 생성을 시작하지 못했어요."와 체리 충전하기 버튼이 나옵니다. 시간당 접수 한도에 닿으면 "이번 시간에는 영상을 N회까지 접수할 수 있어요. 잠시 뒤 다시 시도해 주세요."가 나옵니다.
옵션
모델이 지원하는 옵션만 활성입니다. 모델이 모르는 옵션은 칩으로 나오지 않습니다.
| 옵션 | 뜻 |
|---|---|
| 화면 비율 | 모델이 지원하는 비율 중에서 고릅니다. |
| 해상도 | 모델이 지원하는 해상도입니다. |
| 길이 | 모델이 지원하는 초 단위 값입니다. |
| 오디오 | 켜기/끄기. 소리를 지원하는 모델에서만 켤 수 있습니다. |
| 변형 수 | 한 번에 만들 후보 수입니다. 최대 12개이고 후보마다 체리가 듭니다. |
| 시드 | 생성 옵션 팝오버의 생성 설정에 있습니다. 0~4,294,967,295의 정수이고, 비우면 무작위입니다. 시드를 받지 않는 모델에서는 잠깁니다. |
모델을 바꿨을 때 새 모델이 지원하지 않는 값은 바뀌고 "이 모델이 지원하지 않는 값을 바꿨어요"로 알려 줍니다. 길이·해상도·오디오 조합에 따라 가격이 달라집니다. 조합의 가격을 알 수 없으면 "이 모델은 지금 설정으로 체리 가격을 확인할 수 없어요. 길이·해상도·오디오를 바꿔 보세요"가 나오고 생성이 막힙니다. 비디오에는 프롬프트 향상 버튼이 없습니다.
첨부 칸
입력창 아래에 모델이 받는 칸만 나옵니다. 각 칸에는 필수 또는 선택 표시가 있고, 여러 장을 받는 칸에는
현재/최대가 보입니다. 칸의 메뉴에서 올리기(내 컴퓨터의 파일)나 에셋 고르기(내 에셋)를 고릅니다. 자세한 방법은 참고 파일 올리기에 있습니다.| 칸 | 받는 것 | 언제 나오나 |
|---|---|---|
| 첫 프레임 | 이미지 1장 | 모델이 첫 프레임을 받을 때 |
| 끝 프레임 | 이미지 1장 | 모델이 첫·끝 프레임 두 장을 받을 때 |
| 레퍼런스 | 이미지, 비디오, 오디오 중 모델이 받는 종류 | 모델이 참조 미디어를 받을 때. 장수 상한은 모델이 정하고, 모델이 정하지 않으면 9개입니다. |
| 편집할 영상 | 비디오 1개(필수) | 원본 영상을 고치는 모델일 때. 이 칸만 나옵니다. |
이미지를 첫 프레임으로 영상 만들기: 첫 프레임 칸을 지원하는 모델을 고르고, 첫 프레임에 이미지를 넣은 뒤 움직임을 설명합니다. 끝 프레임도 넣으면 두 장면 사이를 이어 줍니다.
넣기 규칙은 다음과 같습니다.
- 프레임과 레퍼런스는 한 요청에 함께 쓸 수 없습니다. 한쪽이 차 있으면 다른 쪽이 "프레임을 쓰는 중에는 레퍼런스를 함께 쓸 수 없어요" 또는 "레퍼런스를 쓰는 중에는 프레임을 함께 쓸 수 없어요"로 잠깁니다.
- 끝 프레임만으로는 만들 수 없습니다. "끝 프레임만으로는 만들 수 없어요. 첫 프레임을 넣어 주세요."
- 필수 칸이 비면 "첫 프레임이 필요해요", "레퍼런스를 N개 더 넣어 주세요", "편집할 영상을 넣어 주세요"가 나오고 생성이 막힙니다.
- 이 모델이 받지 않는 종류는 "이 모델은 이 입력을 받지 않아요", 칸이 받지 않는 파일 형식은 "이 칸에서 받지 않는 파일 형식이에요", 상한을 넘으면 "최대 N개까지 넣을 수 있어요"가 나옵니다.
- 모델을 바꾸면 새 모델에 없는 칸의 파일과 상한을 넘는 파일은 빠집니다.
먼저 싸게 보기(초안)
모델이 더 싼 초안 모델을 가지고 있으면, 입력창 오른쪽 프리비주얼 메뉴에 싼 모델로 먼저 보기가 활성입니다. 초안은 결과 카드에 초안 표시가 붙고, 마음에 들면 카드 메뉴의 본 생성으로 같은 입력을 본 모델로 만듭니다. 초안 가격을 알 수 없는 설정에서는 "이 설정으로는 먼저 보기를 쓸 수 없어요"가 나옵니다.
만드는 데 걸리는 시간
영상은 이미지보다 오래 걸립니다. 접수한 뒤 45분 안에 끝나지 않으면 실패로 닫히고 체리가 환불됩니다. 끝날 때까지 카드에 진행 상태가 보입니다. 대기 중인 작업은 카드의 작업 취소로 취소할 수 있습니다. 이미 제공자에게 넘어간 작업은 "제공자에게 이미 제출되어 취소할 수 없어요"로 잠깁니다.
결과 확인
끝난 영상은 생성 내역의 카드에 길이와 함께 나오고, 내 에셋에 자동 저장됩니다. 카드의 더보기 메뉴에서 다음을 합니다. 지금 할 수 없는 항목은 숨거나 이유와 함께 잠깁니다.
- 작업 상세 보기, 프롬프트·설정 재사용, 본 생성(초안일 때), 변형 만들기(시드를 받는 모델에서만), 다운로드, 공개 공유
- 캔버스에서 열기, 에디터로 보내기, 에셋에서 보기
- 레퍼런스로 추가(결과를 다음 생성의 레퍼런스로), 프로젝트에 추가, 이 비디오로 편집, 결과를 노드에 다시 연결
- 작업 삭제
실패한 카드에는 이유와 다시 만들기가 나옵니다. 환불 규칙은 오류와 지출에 있습니다.
외부 연결(MCP·API)에서 만들기
연결과 열쇠는 연결과 인증에서 만들고 영상 생성 기능을 허용합니다. 영상은 캔버스 문서의 한 시점(revision)을 기준으로 만듭니다. 모델, 길이, 해상도, 첫 프레임 같은 입력은 문서의 영상 노드에 들어 있고, 서버가 모델 카탈로그로 검증합니다.
MCP
영상 생성 서버(
/video-gen/mcp)의 도구는 다음과 같습니다.| 도구 | 하는 일 | 모드 |
|---|---|---|
video_guide | 사용 절차와 주의점 | 읽기 |
video_query | action으로 models(모델·길이·해상도·오디오·견적표), generations, generation, audio 조회 | 읽기 |
video_quote | 클립 견적과 quote_token 발급 | 읽기 |
video_generate | kind가 clip이면 영상 후보 접수, audio면 배경 음악 접수 | 지출 |
video_cancel | 대기 중인 클립 취소 | 취소 |
video_run | 캔버스 문서의 노드 실행. 캔버스 실행을 보세요. | 지출 |
video_batch_plan, video_batch_confirm, video_plan | 여러 장면 일괄 생성의 계획·확정·조회·취소 | 생성·지출·취소 |
순서는 다음과 같습니다.
- 영상 저작 서버의
create_video_document로 문서를 만들고,propose_video_operations로 영상 노드를 채웁니다(수정은 제안이고, 적용은 사용자가 앱에서 승인합니다). 이미 있는 비디오 프로젝트의 문서를 써도 됩니다. video_query의models로 모델과 견적표(cherry_quotes)를 읽습니다. 견적표가 없는 모델은 가격이 확정되지 않아 유료 생성에 쓸 수 없습니다.video_quote로 견적을 받고, 금액과 잔액을 사용자에게 보여 줍니다.- 동의를 받으면
video_generate에kind: "clip",documentId,revision,quoteToken, 새idempotencyKey를 넣어 접수합니다.candidateCount는 1~12이고 후보마다 작업과 과금이 따로입니다. video_query의generation으로 조회합니다. 진행 중이면 응답의poll_after_seconds(10초) 뒤에 다시 부릅니다.
모델마다
operation(generate, edit, upscale), requires_source_video, generation_axes_published가 함께 옵니다. requires_source_video가 참인 모델은 소스 영상 참조가 정확히 1개 필요하고, generation_axes_published가 거짓이면 길이·해상도·비율 값을 보내면 안 됩니다. 참조 미디어에 실존 인물이 있으면 막지 않고 경고가 붙으니, 본인 사진이거나 허락받은 사진만 쓰세요.본 생성(
tier: "final")은 같은 입력으로 끝난 초안이 있으면 draftJobId 없이 접수할 수 없습니다. 초안(tier: "draft")은 모델이 초안을 지원할 때만 됩니다.공개 REST
GET /v1/models/video로 모델과 체리 견적표를 보고, POST /v1/videos로 접수합니다. 요청에는 documentId, revision, 감수할 상한 maxCherry, idempotencyKey가 필요하고, 응답은 202(이미 접수된 키는 200)입니다. GET /v1/videos/<작업 id>로 조회하고, 응답에 poll_after_seconds가 없으니 10초 간격으로 부르세요. 시간당 접수는 후보 작업 기준 60개, 동시에 진행하는 작업은 24개까지입니다.