동영상 생성
BizRouter는 Google Veo 3.1, Gemini Omni Flash, xAI Grok Imagine, ByteDance Seedance 2.5를 통해 고품질 동영상을 생성합니다. 비동기 방식으로 작동하며, 생성이 완료되면 프록시 다운로드 API를 통해 동영상을 받을 수 있습니다. 동영상 생성 모델 선택 GET /v1/models 에서 output_modalities 에 video 가 포함된 모델을 선택하십시오. 현재 이 endpoint는 Google의 Veo 및 Gemini Interactions API, xAI의 Grok Imagine API, BytePlus ModelArk의 Seedance 작업 API를 사용합니다.
모델별 요청 제약
동일한 endpoint를 사용하지만 지원 옵션과 과금 방식이 다릅니다 Veo 3.1 패밀리: 4/6/8초, 모델별 720p·1080p·4K, negative_prompt와 첫/마지막 프레임을 지원하며 초당 과금합니다. Gemini Omni Flash: 3~10초(1.2는 3~15초), 360p·720p·1080p·4K(업스케일), 16:9 또는 9:16을 지원합니다. 첫 프레임 이미지 또는 참조 이미지 1~6장을 사용할 수 있지만 둘을 함께 보낼 수 없고, negative_prompt는 지원하지 않습니다. google/gemini-omni-1.2-flash 는 첫/마지막 프레임 보간( image + last_frame , 3~10초)과 참조 영상 reference_videos 를 지원합니다. 참조 영상은 영상당 3초 이하를 {"mime_type": "video/mp4", "data_base64": "..."} 처럼 직접 담아 보내며(URL 불가), 3~10초 영상에는 최대 3개, 11~15초 영상에는 1개를 쓸 수 있고 새 생성에만 쓸 수 있습니다. 참조 영상은 첫/마지막 프레임과 함께 보낼 수 없습니다. 생성 비용은 실제 비디오 출력 토큰(초당 360p 1,931 · 720p 5,792 · 1080p 8,688 · 4K 17,376 토큰)으로 정산되므로 길이와 해상도에 비례합니다. 생성한 영상은 아래 「Gemini Omni 영상 이어 만들기」처럼 연장하거나 고칠 수 있습니다. Grok Imagine (xAI): x-ai/grok-imagine-video-1.5 , x-ai/grok-imagine-video-1.5-lite 와 x-ai/grok-imagine-video 는 1~15초, 480p·720p·1080p ( grok-imagine-video 는 1080p 미지원), 화면 비율 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3을 지원합니다. 첫 프레임 image 는 세 모델 모두 받고, reference_images 최대 3장(해상도 720p 이하)은 grok-imagine-video-1.5 와 grok-imagine-video 만 받습니다 ( grok-imagine-video-1.5-lite 에 보내면 xAI가 400으로 거절합니다. 2026-11-03 확인). 둘을 함께 보낼 수 없고, negative_prompt와 last_frame은 지원하지 않습니다. 모델이 지원하지 않는 해상도( grok-imagine-video 의 1080p 등)는 비즈라우터가 xAI를 호출하기 전에 400으로 거절하고, 응답에 그 모델의 해상도 목록을 담습니다. Veo와 같이 길이와 해상도에 따른 초당 과금이며 접수 시점에 비용이 확정됩니다. Seedance 2.5 (ByteDance · BytePlus): bytedance/seedance-2.5 는 4~30초, 480p·720p·1080p, 화면 비율 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · adaptive(모델이 결정)를 지원하고 소리를 함께 만듭니다. 첫 프레임 image (+ last_frame ) 또는 참조 이미지 reference_images 최대 30장을 쓸 수 있으며, 첫 프레임을 주면 화면 비율은 이미지 비율(adaptive)을 따릅니다. Seedance 전용 필드( generate_audio , seed , watermark , return_last_frame , omni_reference_task_type , output_format , draft , priority , safety_identifier , execution_expires_after , callback_url , URL 배열 reference_audios )를 같은 요청에 함께 보낼 수 있습니다. 이 필드를 다른 모델에 보내면 400으로 거절합니다. 참조 영상 reference_videos 는 Seedance에서는 URL 배열이고(Gemini Omni 1.2는 영상을 직접 담아 보냄), Veo와 Grok Imagine에 보내면 400으로 거절합니다. negative_prompt는 지원하지 않습니다. 성공한 영상만 실제 사용 토큰으로 비동기 정산하며, 실패·만료·취소된 작업은 0원입니다.
Seedance: BytePlus 호환 작업 API
BytePlus ModelArk의 영상 생성 작업 API와 같은 요청·응답으로 호출합니다 BytePlus 공식 SDK나 기존 코드는 기본 URL과 API 키만 바꾸면 그대로 동작합니다. model 에는 bytedance/seedance-2.5 또는 BytePlus 모델 ID dreamina-seedance-2-5-260628 를 넣습니다. 본문은 공식 문서의 필드( content[] 의 text · image_url(first_frame / last_frame / reference_image) · video_url(reference_video) · audio_url(reference_audio) · draft_task, resolution, ratio, duration(-1 포함), generate_audio, watermark, seed, return_last_frame, omni_reference_task_type, output_format, draft, service_tier, callback_url, execution_expires_after, priority, safety_identifier)를 그대로 받고, 문서에 없는 필드는 400으로 거절합니다. 상태가 succeeded 이면 content.video_url (·last_frame_url)은 BytePlus 서명 URL입니다. 24시간 동안 최대 100회 내려받을 수 있으니 바로 저장하십시오. 정산이 끝나면 usage.cost 에 원화 비용이 함께 옵니다. 같은 작업 ID는 GET /v1/video/generation/ { id } 와 다운로드 API로도 조회할 수 있습니다. 작업 조회는 생성 후 7일까지 가능합니다. execution_expires_after 는 3,600~82,800초(23시간)만 받고, 생략하면 82,800초로 보냅니다(BytePlus 기본 48시간보다 짧음). 초안 영상( draft: true , 480p)을 만든 뒤 {"type": "draft_task", "draft_task": {"id": "cgt-..."}} 와 resolution: "1080p" 로 최종 영상을 만들 수 있습니다. 초안은 같은 조직이 BizRouter로 만든 것이어야 합니다. 실행 중이거나, 끝났지만 아직 정산되지 않은 작업은 삭제할 수 없습니다(409). 작업 목록 API( GET /v1/contents/generations/tasks )는 제공하지 않습니다. callback_url 을 주면 BytePlus가 그 주소로 직접 상태를 보냅니다. 이 본문의 model은 BytePlus 모델 ID입니다. 과금: 성공한 영상의 usage.completion_tokens × 1M 토큰당 $10.70(480p·720p) / $11.70(1080p), 참조 영상을 넣으면 $6.40 / $7.00. 실패·만료·취소는 0원입니다.
Gemini Omni 영상 이어 만들기 (연장·편집)
앞서 만든 Omni 영상을 이어서 늘리거나 고칩니다 previous_operation_id 에 이전 Gemini Omni 요청이 돌려준 operation_id 를 넣고, 프롬프트에 어떻게 이어질지 적습니다. Google 공식 필드 이름인 previous_interaction_id 로 보내도 같습니다. 연장은 「Extend this video: …」처럼, 편집은 「Make the violin invisible.」처럼 프롬프트로 지시합니다. 연장은 한 번에 3~10초( duration_seconds , 15초 영상을 만드는 1.2도 같음)를 덧붙이며, 다운로드하면 원본과 연장분이 이어진 영상 한 편이 내려옵니다. 다음 연장은 방금 받은 operation_id 로 요청합니다. 총 길이: Google 문서는 총 40초까지 이어 만들 수 있다고 안내하지만, 실제로는 한 영상이 총 30초를 넘지 못합니다(2026-10-30 Google API 직접 확인: 20초+10초, 25초+5초는 30초로 성공, 25초+10초와 30초+5초는 Google이 실패로 끝내고, 30초+10초는 영상이 늘지 않은 채 완료로 응답). 이전 영상 길이와 요청 duration_seconds 의 합이 30초를 넘으면 비즈라우터가 Google에 보내기 전에 400으로 거절하고 과금하지 않으며, 응답에 더 늘릴 수 있는 길이를 알려줍니다. 편집도 같은 방식으로 합산하므로, 30초에 가까운 영상의 편집은 거절될 수 있습니다. Google이 실패로 끝낸 요청은 과금하지 않고, 상태 조회의 error 에 Google이 남긴 사유가 담깁니다. 같은 조직이 같은 모델로 만든 영상만 이어 만들 수 있습니다. 이전 영상은 생성하거나 마지막으로 이어 만든 뒤 24시간 동안 이어 만들 수 있습니다. 이어 만들기 요청에는 task 와 image (첫 프레임)를 함께 보낼 수 없습니다. 모델이 프롬프트를 보고 연장인지 편집인지 판단합니다. 새 인물이나 사물은 reference_images 로 넣고 프롬프트에서 <IMAGE_REF_0> 처럼 가리킵니다. 과금은 새로 만든 길이만 비디오 출력 토큰으로 청구되고, 이전 영상의 마지막 10초가 입력 토큰(초당 약 5,800 토큰, 입력 단가)으로 함께 청구됩니다. 3초 연장 실측 예: 비디오 출력 17,376 토큰 + 입력 16,616 토큰. Veo와 Grok Imagine은 이어 만들기를 지원하지 않으며, 이 필드를 보내면 400 오류를 반환합니다.
비동기 처리 흐름
동영상 생성은 비동기로 처리됩니다 1 생성 요청 POST /v1/video/generation으로 동영상 생성을 요청합니다 2 operation_id 수신 생성 완료를 기다리지 않고 operation_id가 반환됩니다 3 상태 폴링 GET /v1/video/generation/:operation_id로 완료 여부를 확인합니다 4 동영상 다운로드 완료 시 GET /v1/video/generation/:operation_id/download로 동영상을 다운로드합니다 생성 시간 일반적으로 수 분이 걸릴 수 있지만 처리 시간은 Provider 부하와 요청 조건에 따라 달라지며 SLA가 아닙니다. 5~10초 간격으로 polling하고 애플리케이션 자체 timeout을 충분히 길게 설정하십시오.
API 엔드포인트
동영상 생성 및 상태 확인
API 엔드포인트 · 요청 파라미터
model 동영상 생성 모델 ID (필수) prompt 동영상 설명 텍스트 (필수, 영문 권장, 최대 4,000자) duration_seconds 동영상 길이 - Veo 4/6/8초, Omni 3~10초(1.2는 3~15초, 이어 만들기는 3~10초), Grok Imagine 1~15초 (기본값: 8) · Veo 4초/6초는 720p 전용 resolution 해상도 - Veo "720p"/"1080p"/"4k", Omni "360p"/"720p"/"1080p"/"4k" (1.1·1.2, 미리보기는 720p), Grok Imagine "480p"/"720p"/"1080p" (기본값: "720p") · 1080p/4k는 Veo 8초 요청에 사용 · 모델이 지원하지 않는 해상도(grok-imagine-video의 1080p 등)는 Provider 호출 전에 400으로 거절하며 응답에 지원 해상도 목록을 담음 aspect_ratio 화면 비율 - "16:9", "9:16" (기본값: "16:9") · Grok Imagine은 "1:1", "4:3", "3:4", "3:2", "2:3"도 지원 negative_prompt 제외할 요소 (선택사항, Veo 전용 · Omni/Grok Imagine 미지원) image 첫 프레임 이미지 (선택사항, Image-to-Video) - 아래 이미지 입력 섹션 참고 last_frame 마지막 프레임 이미지 (선택사항, Veo · Seedance · Gemini Omni 1.2(3~10초), image와 함께 사용해야 함 · Omni 1.1/미리보기 · Grok Imagine 미지원) reference_images 참조 이미지 배열 (선택사항, Veo 최대 3장·8초 전용, Omni 1~6장, Grok Imagine 최대 3장·720p 이하·grok-imagine-video-1.5와 grok-imagine-video만(-1.5-lite 미지원), image/last_frame과 병용 불가) reference_videos 참조 영상 배열 (선택사항) - Gemini Omni 1.2는 {"mime_type", "data_base64"} 로 직접 담은 영상만(영상당 3초 이하, 3~10초 영상 최대 3개 · 11~15초 1개, 새 생성 전용, image/last_frame과 병용 불가) · Seedance는 URL 배열 · Veo/Grok Imagine 미지원 previous_operation_id 이어 만들 이전 영상의 operation_id (선택사항, Gemini Omni 전용 · 별칭 previous_interaction_id) - 위 「Gemini Omni 영상 이어 만들기」 참고 task 생성 방식 (선택사항, Gemini Omni 전용) - "text_to_video"/"image_to_video"/"reference_to_video" · 생략하면 입력으로 판단 · "edit"/"extend"는 영상 입력이 필요하므로 previous_operation_id를 사용하며, 이때는 task를 보내지 않습니다
API 엔드포인트 · 응답 (202 Accepted)
Veo와 Grok Imagine은 접수 시점에 확정 비용을 cost_krw로 반환합니다. Gemini Omni는 실제 사용량 정산 전에는 이 필드를 생략합니다.
이미지 입력 (Image-to-Video)
이미지를 기반으로 동영상 생성
이미지 입력 (Image-to-Video) · 이미지 객체 형식
mime_type "image/jpeg", "image/png", "image/webp"만 지원 (GIF 불가) data_base64 base64 인코딩 문자열 (data: URL 접두사 없이) - 이미지당 base64 기준 최대 20MB (원본 약 15MB)
이미지 입력 (Image-to-Video) · 1. 첫 프레임 지정 (image)
이미지를 동영상의 첫 프레임으로 사용합니다.
이미지 입력 (Image-to-Video) · 2. 첫/마지막 프레임 보간 (image + last_frame)
두 이미지 사이를 자연스럽게 이어주는 동영상을 생성합니다. last_frame은 image가 있어야만 사용할 수 있습니다.
이미지 입력 (Image-to-Video) · 3. 참조 이미지 (reference_images)
최대 3장의 참조 이미지로 캐릭터·스타일을 유지하며 생성합니다. duration_seconds는 8초여야 하며, image/last_frame과 함께 사용할 수 없습니다.
상태 확인 API
생성 진행 상황 조회
상태 확인 API · 응답 (완료)
video_uri는 보안을 위해 프록시 다운로드 경로로 반환됩니다. 인증 헤더와 함께 GET 요청을 보내 동영상을 다운로드하십시오.
상태 확인 API · 응답 (실패)
cost_krw는 생성 요청 접수 시점에 산정된 비용입니다. 비동기 작업의 failed 상태가 자동 환불을 의미하지 않으므로 비용 이의가 있으면 operation_id와 함께 지원팀에 문의하십시오.
상태 확인 API · 상태 값
pending 요청이 접수됨 processing 동영상 생성 중 completed 생성 완료 - video_uri 사용 가능 failed 생성 실패 - error 메시지 확인
동영상 다운로드 API
생성된 동영상 파일 다운로드
동영상 다운로드 API · 요청 헤더
생성 요청과 같은 조직의 유효한 서비스 API Key가 필요합니다. 생성 요청에 사용한 Key와 동일할 필요는 없습니다.
동영상 다운로드 API · 응답
Content-Type video/mp4 Content-Disposition attachment; filename="video_xxx.mp4" 동영상 파일이 바이너리 스트림으로 반환됩니다. 다운로드 유효기간 동영상 다운로드는 생성 완료 후 30분 동안 가능합니다. 이후에는 다시 동영상을 생성해야 합니다. Model별 조합 확인 duration, resolution, reference image 조합은 Provider 정책에 따라 변경될 수 있습니다. BizRouter request validation을 통과하더라도 Provider가 지원하지 않는 조합은 Provider 오류로 반환될 수 있습니다. 모델별 과금 Veo 3.1과 Grok Imagine은 요청 길이와 해상도에 따른 초당 가격으로 즉시 정산합니다. Seedance 2.5는 성공한 영상의 보고 토큰으로 비동기 정산합니다(실패 0원). Gemini Omni Flash는 입력, 텍스트·사고 출력, 비디오 출력 토큰의 실제 사용량으로 비동기 정산하며, 정산이 완료된 경우에만 cost_krw 로 확정 비용을 반환합니다. 비디오 출력 토큰은 요청한 길이 × 해상도별 초당 토큰(360p 1,931 · 720p 5,792 · 1080p 8,688 · 4K 17,376)으로 보고되므로 생성 비용은 길이와 해상도에 비례합니다(4K는 720p의 3배). 이어 만들기는 이전 영상의 마지막 10초가 입력 토큰으로 더해집니다. 모델별 가격은 통합 모델 가격표 에서 확인해야 합니다.
프롬프트 작성 가이드
효과적인 동영상 프롬프트 작성법 영문 프롬프트 권장 Veo 3.1은 영문 프롬프트에서 가장 좋은 결과를 보여줍니다. 구체적인 설명 주체, 동작, 배경, 조명, 스타일을 명확하게 기술하십시오. 카메라 지시 close-up, wide shot, pan, zoom 등 카메라 움직임을 지정할 수 있습니다.
프롬프트 작성 가이드 · 프롬프트 예시
자연 풍경 제품 영상 애니메이션 스타일
클라이언트 구현 예제
동영상 생성 및 폴링 코드 cURL Node.js Python
에러 처리
동영상 생성 실패 시 응답
에러 처리 · Operation 만료
Operation 상태 확인은 생성 후 1시간, 다운로드는 완료 후 30분 동안 가능합니다.
에러 처리 · 파라미터 검증 오류
해상도·길이 조합, 프롬프트 길이, 이미지 형식/크기 등이 규칙에 맞지 않으면 400 오류가 반환됩니다.
에러 처리 · 일반적인 에러 코드
400 잘못된 요청 (모델 오류, 파라미터 오류 등) 401 인증 실패 (API 키 오류) 403 모델 블랙리스트, 크레딧 부족 404 모델을 찾을 수 없음 429 요청 한도 초과 502 프로바이더 오류
제한사항
지원 길이 Veo 4/6/8초 · Omni 3~10초(1.2는 3~15초) · Grok 1~15초 Veo 1080p/4K는 8초만 지원 지원 해상도 360p, 480p, 720p, 1080p, 4K Veo Lite는 4K 미지원 · Omni 미리보기는 720p, 1.1·1.2는 360p와 1080p/4K(업스케일) 추가 · Grok는 480p~1080p (grok-imagine-video는 1080p 미지원) 화면 비율 16:9, 9:16 Grok Imagine은 1:1, 4:3, 3:4, 3:2, 2:3 추가 지원 Operation 유효기간 1시간 프롬프트 최대 길이 4,000자 이미지 입력 JPEG, PNG, WebP 장당 최대 약 15MB · 참조 이미지 Veo 최대 3장, Omni 최대 6장, Grok Imagine 최대 3장(720p 이하) 다운로드 유효기간 동영상 다운로드는 생성 완료 후 30분 동안 가능합니다. 동영상을 보관하려면 완료 즉시 다운로드하여 저장해야 합니다. Gemini Omni 영상을 이어 만들 수 있는 기간(24시간)과는 별개입니다. 콘텐츠 정책 Google의 콘텐츠 정책을 위반하는 프롬프트는 생성이 거부됩니다. 폭력적, 성적, 불법적인 콘텐츠 생성은 지원되지 않습니다.