메인 콘텐츠로 건너뛰기
POST
/
v1
/
videos
/
generations
Veo-3.1-Generate-Preview API
curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "veo-3.1-generate-preview",
  "prompt": "A cat playing piano"
}
'
{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "veo-3.1-generate-preview"
}

인증

​
Authorization
string
header
필수

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

API Key 받기:

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

요청 헤더에 추가:

Authorization: Bearer YOUR_API_KEY

본문

application/json
​
model
string
기본값:veo-3.1-generate-preview
필수
​
prompt
string
필수

프롬프트, 최대 2000 토큰

Maximum string length: 2000
​
image_urls
string<uri>[]

참조 이미지, 최대 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
​
n
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: 인물/얼굴 불허

사용 가능한 옵션:
allow_adult,
dont_allow
​
resize_mode
enum<string>

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

사용 가능한 옵션:
pad,
crop
​
callback_url
string<uri>

응답

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

​
created
integer
예시:

1757169743

​
id
string
예시:

"task-unified-1757169743-7cvnl5zw"

​
model
string
예시:

"veo-3.1-generate-preview"

​
status
enum<string>
사용 가능한 옵션:
pending,
processing,
completed,
failed