curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kling-v4-flash-reference-to-video",
  "prompt": "<<<video_1>>>의 움직임 스타일을 유지하고 배경을 설경으로 바꾼다",
  "video_urls": [
    "https://example.com/reference.mp4"
  ],
  "duration": 5,
  "aspect_ratio": "16:9",
  "quality": "720p"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "kling-v4-flash-reference-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 300,
    "video_duration": 5
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 42.84,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "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: kling-v4-flash-reference-to-video",
    "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"
  }
}

Kling-4.0-Flash

Kling-4.0-Flash 참조-비디오 변환

Kling-4.0 Flash Reference to Video (kling-v4-flash-reference-to-video)는 참조 이미지와 비디오를 기반으로 새로운 비디오를 생성합니다
참조 비디오는 특징 참조용으로 사용되며(직접 편집이 아님), 텍스트 및 참조 이미지와 결합할 수 있습니다
720p만 지원하며, 길이는 3~20초입니다
비동기 처리 모드이며, 반환된 작업 ID를 사용하여 상태 조회
생성된 비디오 링크는 24시간 동안 유효하며, 즉시 저장하시기 바랍니다

Flash와 Kling 4.0 선택 가이드

Flash는 잦은 제작과 빠른 아이디어 반복 작업을 위한 모델입니다. 생성 속도와 비용 효율에 중점을 두며, 짧은 720p 비디오 제작에 적합합니다. 아래 표는 EvoLink API가 현재 지원하는 기능을 비교한 것입니다.

항목	Kling 4.0 Flash	Kling 4.0
출력 해상도	`720p`	`720p`, `1080p`
출력 길이	`3`~`20`초	`3`~`30`초
참조 이미지	최대 `10`장	최대 `10`장
참조 비디오	최대 `5`개, 총 길이 `20`초 이하	최대 `5`개, 총 길이 `30`초 이하

참조 비디오의 총 길이와 출력 길이에는 각각 별도의 제한이 적용됩니다. 출력 길이를 줄여도 입력 제한이 늘어나지 않습니다. 더 긴 참조 비디오, 1080p 출력 또는 20초를 넘는 출력이 필요하면 Kling 4.0 참조를 비디오로를 사용하세요.

Flash는 별도의 모델 ID를 사용합니다. 전환할 때 model, quality, duration을 함께 확인하세요. 실제 요금은 선택한 Flash 모델의 현재 가격과 작업의 최종 정산 결과에 따라 결정됩니다.

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": "kling-v4-flash-reference-to-video",
  "prompt": "<<<video_1>>>의 움직임 스타일을 유지하고 배경을 설경으로 바꾼다",
  "video_urls": [
    "https://example.com/reference.mp4"
  ],
  "duration": 5,
  "aspect_ratio": "16:9",
  "quality": "720p"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "kling-v4-flash-reference-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 300,
    "video_duration": 5
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 42.84,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "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: kling-v4-flash-reference-to-video",
    "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>

기본값:kling-v4-flash-reference-to-video

필수

비디오 생성 모델 이름

사용 가능한 옵션:

kling-v4-flash-reference-to-video

예시:

"kling-v4-flash-reference-to-video"

prompt

string

필수

텍스트 프롬프트, 최대 2500자

참조 구문: 프롬프트에서 <<<xxx>>>를 사용하여 이미지와 비디오를 참조할 수 있습니다. 예: <<<image_1>>>의 인물이 <<<video_1>>>의 카메라 움직임에 맞춰 거리를 걷는다

Maximum string length: 2500

예시:

"<<<image_1>>>의 인물이 <<<video_1>>>의 카메라 움직임에 맞춰 거리를 걷는다"

video_urls

string<uri>[]

참조 비디오 URL 배열. 최대 5개이며 순서대로 프롬프트의 <<<video_1>>>, <<<video_2>>> 등에 대응합니다

비디오 요구 사항:

형식: MP4 / MOV
크기: 비디오당 ≤ 200MB
길이: 비디오당 ≥ 3초, 전체 합계 ≤ 20초
크기: 너비와 높이 각각 720px~2160px
프레임 속도: 24fps~60fps
비디오 URL은 서버에서 직접 접근할 수 있어야 합니다

Maximum array length: 5

예시:

["https://example.com/reference.mp4"]

image_urls

string<uri>[]

참조 이미지 URL 배열(스타일, 장면, 피사체 참조). 순서대로 프롬프트의 <<<image_1>>>, <<<image_2>>> 등에 대응합니다

제약: 최대 10장 참고: 이미지 URL은 서버에서 직접 접근할 수 있거나 접근 시 바로 다운로드되어야 합니다

Maximum array length: 10

예시:

["https://example.com/character.jpg"]

duration

integer

기본값:5

비디오 길이(초). 기본값은 5초입니다

범위:

3~20 사이의 정수

필수 범위: 3 <= x <= 20

예시:

5

aspect_ratio

enum<string>

기본값:16:9

비디오 화면 비율

옵션:

16:9: 가로
9:16: 세로
1:1: 정사각형
21:9: 울트라와이드

사용 가능한 옵션:

16:9,

9:16,

1:1,

21:9

예시:

"16:9"

quality

enum<string>

기본값:720p

해상도 등급

옵션:

720p만 지원합니다

사용 가능한 옵션:

720p

예시:

"720p"

callback_url

string<uri>

작업 완료 시 HTTPS 콜백 URL

콜백 시점:

작업이 완료, 실패 또는 취소될 때 트리거됩니다
과금 확인 후 전송됩니다

보안 제한:

HTTPS 프로토콜만 지원
내부 IP 주소 금지 (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x 등)
URL 길이는 2048자를 초과할 수 없습니다

콜백 메커니즘:

타임아웃: 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

실제 사용된 모델 이름

예시:

"kling-v4-flash-reference-to-video"

object

enum<string>

작업 유형

사용 가능한 옵션:

video.generation.task

progress

integer

작업 진행률 (0-100)

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

예시:

0

status

enum<string>

작업 상태

사용 가능한 옵션:

pending,

processing,

completed,

failed

예시:

"pending"

task_info

object

비디오 작업 세부 정보

Show child attributes

type

enum<string>

작업 출력 유형

사용 가능한 옵션:

text,

image,

audio,

video

예시:

"video"

usage

object

사용량 및 과금 정보

Show child attributes

이미지 시리즈

비디오 시리즈

오디오 시리즈

텍스트 시리즈

계정 관리

작업 관리

파일 관리

Kling-4.0-Flash 참조-비디오 변환

Flash와 Kling 4.0 선택 가이드

인증

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

본문

응답