Veo 3.1 동영상 생성 API

Google 공식 모델 ID를 하나의 비동기 API로 사용합니다. 공식 및 Ext 공급자 모델명은 서버에서 변환하며 생성, 조회, 다운로드 절차는 같습니다.

• veo-3.1-generate-preview — Veo 3.1
• veo-3.1-fast-generate-preview — Veo 3.1 Fast

매개변수와 경로 기능

기본값은 8초, 720p, 16:9, 오디오 켜짐입니다. 공식 경로는 4·6·8초, Ext는 8초만 지원합니다. 1080p와 4K는 8초가 필요합니다. 작업당 동영상은 하나입니다.

공식 경로는 generate_audio:false, negative_prompt, seed(0 포함), person_generation, resize_mode, enhance_prompt:true를 지원합니다. Ext는 오디오를 끌 수 없습니다. 공식 전용 매개변수는 가능한 공식 경로로 전환합니다. 공급자 내부 모델 ID를 사용하지 마세요.

image_urls는 첫 프레임 또는 첫·마지막 프레임을 받습니다. Fast Ext는 참조 이미지 3장(generation_type:reference, 16:9 전용)도 지원합니다. Standard는 3장 참조를 지원하지 않습니다. 공개 HTTP(S) URL이 필요합니다.

{"model":"veo-3.1-generate-preview","prompt":"A paper boat drifting across a quiet lake at sunrise, natural ambient sound","duration":8,"resolution":"720p","aspect_ratio":"16:9","generate_audio":true}

curl "https://apimaster.ai/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"veo-3.1-generate-preview","prompt":"A paper boat drifting across a quiet lake at sunrise","duration":8,"resolution":"720p","generate_audio":true}'

POST https://apimaster.ai/v1/videos → {"id":"task_...","task_id":"task_...","status":"queued"}

id는 접수만 의미합니다. 5~10초마다 completed 또는 failed까지 조회하고, 완료 후 같은 API 키로 즉시 다운로드하여 보관하세요.

curl "https://apimaster.ai/v1/videos/task_..." -H "Authorization: Bearer YOUR_API_KEY"
curl -L "https://apimaster.ai/v1/videos/task_.../content" -H "Authorization: Bearer YOUR_API_KEY" -o video.mp4

queued → in_progress → completed / failed

요금과 환불

표는 Google 공식 기준가(USD/초)입니다. 최종 요금은 경로 계수와 계정 요금 규칙에 따라 달라지므로 모델 카드와 사용 로그를 확인하세요. Ext는 요청당 8초 단위이며 연장도 새로운 8초만 과금합니다. 원본 길이를 중복 과금하지 않습니다. 실패 시 생성 선차감 금액을 환불합니다.

Google model	720p + audio	1080p + audio	4K + audio	720p silent	1080p silent	4K silent
veo-3.1-generate-preview	$0.40/s	$0.40/s	$0.60/s	$0.20/s	$0.20/s	$0.40/s
veo-3.1-fast-generate-preview	$0.10/s	$0.12/s	$0.30/s	$0.08/s	$0.10/s	$0.25/s

Google Gemini API · Google Cloud

동영상 연장

2026-10-17 검증: Standard Ext(veo-3.1-generate-preview)의 영상 연장이 성공했습니다. Fast 연장은 현재 업스트림에서 거부됩니다. 연장할 원본 영상은 Standard로 생성하세요.

완료된 Ext 작업만 같은 모델, 소유자, 원래 경로에서 연장할 수 있습니다. 공식 작업은 지원하지 않습니다. raw:true는 연장 부분만 반환합니다. 잘못된 매개변수는 400, 지정 경로의 기능 부족은 503입니다.

curl "https://apimaster.ai/v1/videos/task_.../remix" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"veo-3.1-generate-preview","prompt":"The paper boat continues past green reeds","raw":false,"resolution":"720p","aspect_ratio":"16:9"}'