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-lite-generate-preview",
  "prompt": "A golden retriever puppy running through a sunlit meadow, slow motion, cinematic lighting"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "veo-3.1-lite-generate-preview",
  "object": "video.generation.task",
  "progress": 0,
  "status": "processing",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 600,
    "video_duration": 4
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 12.24,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: veo-3.1-lite-generate-preview",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Veo3.1

Veo3.1-Lite 비디오 생성

Veo 3.1 Lite는 Veo 3.1의 저가형 모델입니다. 텍스트-비디오, 첫 프레임 / 첫-마지막 프레임 이미지-비디오를 지원하며, 참조 이미지와 4k는 지원하지 않습니다
출력 비디오 초 단위로 과금되며 단가는 해상도와 오디오 생성 여부에 따라 달라집니다. 가격은 EvoLink 모델 가격 참조
비동기 처리 방식입니다. 반환된 작업 ID로 작업 상태를 조회하세요
생성된 영상 링크는 24시간 동안 유효하므로 즉시 저장하세요

POST

videos

generations

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-lite-generate-preview",
  "prompt": "A golden retriever puppy running through a sunlit meadow, slow motion, cinematic lighting"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "veo-3.1-lite-generate-preview",
  "object": "video.generation.task",
  "progress": 0,
  "status": "processing",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 600,
    "video_duration": 4
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 12.24,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: veo-3.1-lite-generate-preview",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

인증

Authorization

string

header

필수

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

API Key 받기:

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

요청 헤더에 추가:

Authorization: Bearer YOUR_API_KEY

본문

application/json

model

enum<string>

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

필수

영상 생성 모델 이름. 이 모델은 image_start, image_end, model_params를 허용하지 않습니다(400 반환)

사용 가능한 옵션:

veo-3.1-lite-generate-preview

예시:

"veo-3.1-lite-generate-preview"

prompt

string

필수

영상을 설명하는 프롬프트로 최대 2000 토큰입니다. cl100k로 계산하며 토큰 수는 문자 수와 다릅니다. Google이 공식 지원하는 프롬프트 언어는 영어입니다. EvoLink는 프롬프트 언어에 따라 요청을 거부하지 않지만 다른 언어의 생성 결과는 보장하지 않습니다.

예시:

"A golden retriever puppy running through a sunlit meadow, slow motion, cinematic lighting"

image_urls

string<uri>[]

이미지-투-비디오용 입력 이미지 URL

참고:

요청당 최대 2장: 1장은 첫 프레임으로, 2장은 첫 프레임과 마지막 프레임으로 사용됩니다
이미지 크기: 10 MB 이하
지원 파일 형식: .jpg, .jpeg, .png

Maximum array length: 2

예시:

["https://example.com/first-frame.jpg"]

generation_type

enum<string>

생성 모드. 생략하면 이미지 수에 따라 자동으로 결정됩니다:

TEXT: 텍스트-투-비디오 (전달한 이미지는 사용되지 않음)
FIRST&LAST: 첫-마지막 프레임, 1-2장 이미지

이 모델은 REFERENCE(참조 이미지)를 지원하지 않으며 400을 반환합니다

사용 가능한 옵션:

TEXT,

FIRST&LAST

aspect_ratio

enum<string>

영상 화면 비율. auto는 aspect_ratio를 생략한 것과 같으며, 비율을 지정하지 않고 모델이 결정합니다

사용 가능한 옵션:

auto,

16:9,

9:16

generate_audio

boolean

기본값:true

오디오 생성 여부, 기본값 true. 오디오를 생성하면 초당 단가가 높아집니다

duration

enum<integer>

기본값:4

영상 길이(초), 기본값 4. 영상이 길수록 비용이 높아집니다

사용 가능한 옵션:

4,

6,

8

integer

기본값:1

생성할 영상 수, 기본값 1. 각 영상은 개별적으로 과금됩니다

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

quality

enum<string>

기본값:720p

출력 해상도, 기본값 720p. 1080p는 초당 단가가 더 높으며, 이 모델은 4k를 지원하지 않습니다

사용 가능한 옵션:

720p,

1080p

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>

이미지에서 동영상을 생성할 때의 이미지 조정 모드. 생략하면 업스트림 기본값인 pad가 사용됩니다. pad: 여백을 추가하여 출력 화면 비율에 맞춤. crop: 중앙을 기준으로 잘라 출력 화면 비율에 맞춤. 입력 이미지가 필요하며, 이미지 없이 이 매개변수를 전달하면 400이 반환됩니다

사용 가능한 옵션:

pad,

crop

callback_url

string<uri>

작업 완료 후 HTTPS 콜백 주소

콜백 타이밍:

작업이 완료 또는 실패할 때 트리거됨
과금 확인 완료 후 전송

보안 제한:

HTTPS 프로토콜만 지원
내부 IP 주소로의 콜백 금지 (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x 등)
URL 길이는 2048 UTF-8 바이트를 초과할 수 없음

콜백 메커니즘:

타임아웃: 10초
실패 시 최대 3회 재시도 (1초/2초/4초 후 재시도)
콜백 응답 본문 형식은 작업 조회 API 응답 형식과 동일
콜백 주소가 2xx 상태 코드를 반환하면 성공으로 간주, 다른 상태 코드는 재시도를 트리거

예시:

"https://your-domain.com/webhooks/video-task-completed"

응답

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

created

integer

작업 생성 타임스탬프

예시:

1757169743

string

작업 ID

예시:

"task-unified-1757169743-7cvnl5zw"

model

string

실제 사용된 모델 이름

예시:

"veo-3.1-lite-generate-preview"

object

enum<string>

작업의 구체적 유형

사용 가능한 옵션:

video.generation.task

progress

integer

작업 진행률 (0-100)

필수 범위: 0 <= x <= 100

예시:

0

status

enum<string>

작업 상태

사용 가능한 옵션:

pending,

processing,

completed,

failed

예시:

"processing"

task_info

object

비디오 작업 상세 정보

Show child attributes

type

enum<string>

작업의 출력 유형

사용 가능한 옵션:

text,

image,

audio,

video

예시:

"video"

usage

object

사용량 및 과금 정보

Show child attributes

이미지 시리즈

비디오 시리즈

오디오 시리즈

텍스트 시리즈

계정 관리

작업 관리

파일 관리

Veo3.1-Lite 비디오 생성

인증

본문

응답