Veo3.1-Fast 비디오 생성

인증

Authorization

string

header

필수

##모든 API는 Bearer Token 인증이 필요합니다##

API Key 받기:

API Key 관리 페이지를 방문하여 API Key를 받으세요

요청 헤더에 추가:

Authorization: Bearer YOUR_API_KEY

본문

application/json

model

string

기본값:veo-3.1-fast-generate-preview

필수

예시:

"veo-3.1-fast-generate-preview"

prompt

string

필수

영상을 설명하는 프롬프트, 최대 2000 토큰

Maximum string length: 2000

예시:

"A cat playing piano"

image_urls

string<uri>[]

참조 이미지 URL, 최대 3장 (FIRST&LAST 모드는 1-2장, REFERENCE 모드는 최대 3장 지원), 각 최대 10MB

Maximum array length: 3

generation_type

enum<string>

생성 모드:

TEXT: 텍스트-투-비디오
FIRST&LAST: 첫-마지막 프레임, 1-2장 이미지
REFERENCE: 참조 이미지, 최대 3장, 길이 8초 고정, 화면 비율 16:9 고정, generate_audio 외 다른 고급 매개변수 미지원

사용 가능한 옵션:

TEXT,

FIRST&LAST,

REFERENCE

aspect_ratio

enum<string>

동영상 화면 비율. auto로 설정 시: 이미지-투-비디오는 입력 이미지 비율에 따라 자동 선택, 텍스트-투-비디오는 프롬프트 내용에 따라 자동 선택

사용 가능한 옵션:

auto,

16:9,

9:16

generate_audio

boolean

오디오 생성 (추가 비용), 기본값 true

duration

enum<integer>

길이 (초), 기본값 4

사용 가능한 옵션:

4,

6,

8

integer

영상 수, 기본값 1

필수 범위: 1 <= x <= 4

quality

enum<string>

해상도, 기본값 720p

사용 가능한 옵션:

720p,

1080p,

4k

seed

integer

필수 범위: 1 <= x <= 4294967295

negative_prompt

string

person_generation

enum<string>

인물 생성 제어, 기본값 allow_adult

사용 가능한 옵션:

allow_adult,

dont_allow

resize_mode

enum<string>

크기 조정 모드 (I2V 전용), 기본값 pad

사용 가능한 옵션:

pad,

crop

callback_url

string<uri>

응답

비디오 생성 작업이 성공적으로 생성되었습니다

created

integer

예시:

1757169743

string

예시:

"task-unified-1757169743-7cvnl5zw"

model

string

예시:

"veo-3.1-fast-generate-preview"

status

enum<string>

사용 가능한 옵션:

pending,

processing,

completed,

failed