2026-09-26모델

AI 영상 편집 API: 프롬프트로 영상 편집하기(video-to-video)

POST /v1/video-router/generate에 gemini-omni-flash-1.1과 video_url을 보내 기존 클립을 프롬프트로 편집하세요. 편집 모드의 입력, 거부, 비용을 다룹니다.

읽는 시간 5분Sume

Sume API로 기존 영상을 프롬프트로 편집하려면 model: "gemini-omni-flash-1.1", 클립의 공개 HTTPS URL을 담은 video_url, 바꿀 내용을 설명하는 프롬프트를 담아 POST /v1/video-router/generate를 보내세요. video_url을 보내면 이 모델의 video_to_video(편집) 모드가 선택됩니다. Sume는 이 모델을 요청 형태에 따라 라우팅하므로 엔드포인트를 직접 고를 필요가 없습니다.

아래 필드와 규칙은 Video Router 문서 (영문)와 이 모델의 카탈로그 항목에서 가져왔으며, 2026-09-26에 확인했습니다.

어떤 모델로 영상을 편집할 수 있나요?

Gemini Omni Flash 1.1(gemini-omni-flash-1.1)입니다. 카탈로그에 나열된 모델 가운데 Video Router 기능에 video_to_video가 들어 있는 모델이 바로 이 모델이며, GET /v1/videos/models의 설명에는 “text/image/reference-to-video and video edit with native synced audio.”라고 적혀 있습니다. 다른 모드는 Gemini Omni Flash 1.1 영상 API에서 다룹니다.

문서는 일반적으로 새 연동에 OpenRouter 호환 POST /v1/videos를 안내합니다(이 경로의 동작 방식). 하지만 문서는 이 모델의 편집 모드를 Video Router의 video_url 필드로 제공하며, model이 카탈로그 ID이면 POST /v1/videos는 video_url을 400 invalid_request로 거부합니다. 그래서 편집 요청은 Video Router로 보냅니다. Video Router는 계속 제공되며 바뀌지 않습니다.

편집 요청은 어떻게 보내나요?

원본 클립은 video_url에 넣고, 편집 내용은 prompt에 설명하세요. 아래는 프로덕션 호스트 기준의 문서 예제입니다.

video_url은 가져올 수 있는 공개 HTTPS URL이어야 합니다. localhost, 사설 네트워크 URL, HTTPS가 아닌 URL, 서명된·비공개 URL은 제출 전에 거부됩니다.
resolution은 선택 사항이며 기본값은 720p입니다.
문서 예제는 Idempotency-Key 헤더와 mode: "async"도 함께 보냅니다.

curl -X POST https://api.sume.com/v1/video-router/generate \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: video-router-edit-001" \
  -d '{
    "model": "gemini-omni-flash-1.1",
    "prompt": "Replace the bottle with an apple. Keep everything else the same.",
    "video_url": "https://example.com/clip.mp4",
    "resolution": "720p",
    "mode": "async"
  }'

편집 모드는 무엇을 받고 무엇을 거부하나요?

편집에는 프롬프트, 원본 클립, 그리고 선택적으로 해상도가 들어갑니다. 이 모델의 나머지 생성 필드는 적용되지 않습니다.

편집 모드 규칙, Video Router (영문)와 `GET /v1/video-router/models/gemini-omni-flash-1.1`의 `constraints` 기준, 2026-09-26 확인. 제출하기 전에 그곳과 `GET /v1/videos/models`에 나온 이 모델의 해상도를 확인하세요.
필드	편집 모드에서
`prompt`	편집 내용 설명
`video_url`	레퍼런스가 아니라 편집할 원본 클립
`resolution`	선택. 기본값 720p
`aspect_ratio`	거부됨
`duration`	모델에 전달되지 않음. 보내면 예약 금액 추정용 힌트로만 쓰임
`image_url`, `end_image_url`, `reference_*_urls`	`video_url`과 함께 보낼 수 없음
`generate_audio`	토글 없음. 네이티브 동기화 오디오가 항상 생성되므로 필드 생략
`bitrate_mode`	이 모델에서는 쓸 수 없음

편집과 레퍼런스 영상은 무엇이 다른가요?

편집 원본은 바꿀 대상인 클립입니다. 레퍼런스 영상은 새 클립의 방향을 잡습니다. Gemini Omni Flash 1.1은 레퍼런스로 영상 만들기에서 각각 최대 3초인 reference_video_urls를 세 개까지 받으며, 이는 video_url과 함께 보낼 수 없습니다. 기존 영상을 참고해 새로 생성하려면 Reference-to-Video API를 참고하세요.

편집된 클립은 어떻게 받나요?

Video Router는 Sume의 { "data": ... } Job 봉투를 반환합니다. Job ID를 저장하고 GET /v1/jobs/{id}/status를 폴링하다가(또는 mode: "sync"나 "subscribe"로 최대 30초까지 기다리다가), result_ready가 true가 되면 GET /v1/jobs/{id}/result를 가져오세요. 결과에는 Sume가 호스팅하는 artifacts가 담깁니다.

영상 편집 요금은 어떻게 청구되나요?

Gemini Omni Flash 1.1은 해상도별 출력 초당 공급사 정가 × 1.25로 청구되며, 기본 5.5% 에이전트 수수료가 더해집니다. 금액은 제출할 때 워크스페이스 USD 잔액에서 예약됩니다. 편집 모드는 duration을 받지 않으므로, 보낸 duration은 그 예약 금액 추정에 쓰는 길이 힌트로만 쓰입니다.

해상도별 요율은 GET /v1/videos/models의 pricing_skus 항목에 있습니다. API 요금도 참고하세요.

출처

작성자 Sume