비디오 생성

텍스트 프롬프트에서 비디오를 생성하는 비동기 API입니다.

Google Veo 등 최신 비디오 생성 모델을 사용하여 고품질 영상을 만들 수 있습니다. 비디오 생성은 작업 제출 → 상태 폴링 → 다운로드의 3단계로 진행됩니다.

공식 레퍼런스: Google Veo (Vertex AI)

참고

생성 시간은 모델에 따라 다릅니다. minimax/h3-max-turbo는 몇 초에서 10초 안쪽, 대부분의 모델은 30~~120초, bytedance/seedance-2.5는 길이와 참조 수에 따라 2~~6분까지 걸릴 수 있습니다. 폴링 간격은 10초를 권장합니다.

operation_id에 슬래시가 포함될 수 있습니다 — 전체 문자열을 그대로 전달하세요
폴링 및 다운로드 URL에 ?model=<모델명>을 반드시 추가하세요 (예: ?model=veo-3.1-fast-generate-preview). 없으면 400 에러가 반환됩니다.

엔드포인트

Method	Path	설명
POST	`/v1/gateway/video/generation/`	비디오 생성 작업 시작
GET	`/v1/gateway/video/generation/{operation_id}/`	작업 상태 폴링
GET	`/v1/gateway/video/generation/{operation_id}/download/`	완성된 비디오 다운로드

1. 비디오 생성 시작

POST/v1/gateway/video/generation/

비동기 비디오 생성 작업을 시작합니다.

파라미터

model

string

required

비디오 모델 이름 (예: veo-3.1-fast-generate-preview, fal-ai/kling-video/v3).

prompt

string

required

생성할 비디오에 대한 텍스트 설명.

parameters

object

모델별 파라미터 (종횡비, 길이 등).

input_urls

array

입력 이미지/비디오 URL (이미지-투-비디오 모델용).

응답

video_model_id는 요청이 실제로 배정된 비디오 모델의 내부 ID입니다. 크레딧 정산과 문의 시 어떤 모델로 처리됐는지 확인하는 용도로 씁니다.

요청 본문은 25MB를 넘을 수 없습니다(초과 시 413). input_urls에 base64 데이터 URL을 넣으면 원본보다 약 33% 커지므로, 입력 이미지는 http(s) URL로 넘기는 편이 안전합니다.

ByteDance(ModelArk) 계열 모델(bytedance/…)에 참조 이미지를 넣을 때는 이미지의 전체 픽셀 수(가로 × 세로)가 36,000,000을 넘을 수 없습니다. 초과한 이미지는 크레딧이 차감되기 전에 400으로 거절되니, 이미지를 줄여서 다시 요청해 주세요.

2. 상태 폴링

GET/v1/gateway/video/generation/{operation_id}/

Query Parameter

model

string

required

비디오 생성 시 사용한 모델 이름 (예: veo-3.1-fast-generate-preview). 이 파라미터가 없으면 400 에러가 반환됩니다.

Google Veo — video_uri가 상대 경로(다운로드 엔드포인트)로 반환됩니다:

Fal/Replicate 제공업체 — video_uri가 직접 다운로드 가능한 CDN URL로 반환됩니다:

Status	의미
`processing`	작업 진행 중
`completed`	비디오 준비 완료
`failed`	생성 실패

3. 비디오 다운로드

GET/v1/gateway/video/generation/{operation_id}/download/

Query Parameter

model

string

required

비디오 생성 시 사용한 모델 이름 (예: veo-3.1-fast-generate-preview). 이 파라미터가 없으면 400 에러가 반환됩니다.

video/mp4 바이트를 직접 스트리밍합니다.

전체 흐름 (Python)

사용 가능한 모델

크레딧은 모델 기본값이며, 조직 설정에 따라 달라질 수 있습니다.

모델	제공업체	크레딧/비디오	주요 파라미터
`veo-3.1-generate-preview`	Google	1,600	`duration_seconds` (4/6/8), `aspect_ratio` (16:9, 9:16)
`bytedance/seedance-2.5`	ByteDance (ModelArk)	1,165	`duration` (5/10/15/30초), `resolution` (480p/720p/1080p), `aspect_ratio`
`fal-ai/vidu/q3`	Vidu (Fal)	770	`duration` (2–16초), `resolution` (360p/540p/720p/1080p), `aspect_ratio`, `audio`
`bytedance/seedance-2.0`	ByteDance (ModelArk)	500	`duration` (5/10), `resolution` (720p/1080p), `aspect_ratio`
`lightricks/ltx-2.5/pro`	Lightricks (Fal)	720	`duration` (6/8/10), `resolution` (720p/1080p), `aspect_ratio`, `generate_audio`
`bytedance/seedance-2.0/fast`	ByteDance (ModelArk)	250	`duration` (5/10), `resolution` (720p), `aspect_ratio`
`veo-3.1-fast-generate-preview`	Google	600	`duration_seconds` (4/6/8), `aspect_ratio` (16:9, 9:16)
`lightricks/ltx-2.5/fast`	Lightricks (Fal)	540	`duration` (6/8/10), `resolution` (720p/1080p), `aspect_ratio`, `generate_audio`
`fal-ai/luma-dream-machine/ray-2`	Luma (Fal)	500	`duration` (5초/9초), `resolution` (540p/720p/1080p), `aspect_ratio`, `loop`
`fal-ai/kling-video/o3`	Kling (Fal)	420	`duration` (3–15초), `aspect_ratio`, `mode` (standard/pro), `generate_audio`
`fal-ai/kling-video/v3`	Kling (Fal)	420	`duration` (3–15초), `aspect_ratio`, `mode` (standard/pro), `generate_audio`
`fal-ai/kling-video/v2.5-turbo/pro`	Kling (Fal)	350	`duration` (5/10), `aspect_ratio`
`fal-ai/pixverse/v5`	PixVerse (Fal)	150	`duration` (5/8), `quality` (360p–1080p), `aspect_ratio`
`xai/grok-imagine-video`	xAI (Fal)	300	`duration` (1–15초), `resolution` (480p/720p), `aspect_ratio`
`fal-ai/minimax/hailuo-02`	MiniMax (Fal)	270	`duration` (6초 고정), `resolution` (768p/1080p)
`minimax/h3-max`	MiniMax (Fal)	400	`duration` (5/10), `resolution` (`480P`/`768P`/`1080P`, 대문자 P), `aspect_ratio` (21:9, 16:9, 4:3, 1:1, 3:4, 9:16)
`minimax/h3-max-turbo`	MiniMax (Fal)	200	`duration` (5/10), `resolution` (`480P`/`768P`/`1080P`, 대문자 P), `aspect_ratio` (21:9, 16:9, 4:3, 1:1, 3:4, 9:16)
`bytedance/seedance-1-pro`	ByteDance (ModelArk)	60	`duration` (2–12초), `resolution` (480p/720p/1080p), `aspect_ratio`
`veo-3.1-lite-generate-preview`	Google	200	`duration_seconds` (4/6/8), `aspect_ratio` (16:9, 9:16)
`bytedance/seedance-1.5-pro`	ByteDance (ModelArk)	130	`duration` (5/10), `resolution` (480p/720p/1080p), `aspect_ratio`
`bytedance/seedance-1.0-pro/fast`	ByteDance (ModelArk)	97	`duration` (5/10), `resolution` (480p/720p/1080p), `aspect_ratio`
`wan3.0-video-prime`	Alibaba (Model Studio)	1,400	`duration` (5초 고정)
`happyhorse-1.1-t2v`	Alibaba (Model Studio)	900	`duration` (5초 고정)
`google/gemini-omni-flash/v1.1`	Google (Fal)	240	`duration` (8초 고정), `resolution` (360p/720p/1080p/4K), `aspect_ratio`

대부분의 모델은 텍스트-투-비디오와 이미지-투-비디오(1개 입력 이미지, input_urls 사용)를 모두 지원합니다. wan3.0-video-prime, happyhorse-1.1-t2v, google/gemini-omni-flash/v1.1은 텍스트-투-비디오 전용이라 입력 이미지를 받지 않습니다.

minimax/h3-max와 minimax/h3-max-turbo는 참조 영상·오디오를 받지 않습니다(이미지 1개만). resolution 값은 다른 모델과 달리 대문자 P(768P)로 보내야 하고, 이미지-투-비디오에서는 비율을 입력 이미지에서 가져오므로 aspect_ratio는 텍스트-투-비디오에서만 지정합니다.

조직에 따라 일부 모델이 활성화되지 않을 수 있습니다. 활성화되지 않은 모델을 사용하면 403 에러가 반환됩니다 — 관리자에게 문의하세요.

크레딧 산정 방식

표의 크레딧은 각 모델의 기본 파라미터(기본 길이·해상도) 기준값입니다. 실제 차감액은 요청한 duration·resolution(모델에 따라 mode·generate_audio)에 따라 달라지며, 길이를 늘리거나 해상도를 올리면 그만큼 커집니다.

예를 들어 bytedance/seedance-2.5는 출력 해상도와 길이에 비례해 산정되고, 표의 1,165는 720p·5초 기준값입니다.

해상도 \ 길이	5초	10초	15초	30초
480p	518	1,032	1,546	3,088
720p	1,165	2,321	3,476	6,943
1080p	2,622	5,222	7,822	15,622

minimax/h3-max와 minimax/h3-max-turbo는 해상도별 초당 크레딧으로 산정됩니다. 표의 400과 200은 768P·5초 기준값이고, 10초는 두 배입니다.

모델	480P	768P	1080P
`minimax/h3-max`	50 크레딧/초	80 크레딧/초	160 크레딧/초
`minimax/h3-max-turbo`	25 크레딧/초	40 크레딧/초	80 크레딧/초

input_urls로 참조 영상을 넣으면 그 길이도 함께 산정됩니다. 참조 이미지는 추가 과금이 없습니다.

실패 건 과금

마지막 수정 날짜: Sep 21, 2026

/images/generate

/documents/parse