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-video-edit",
  "prompt": "Adjust the color to warm tones and add a cinematic feel",
  "video_urls": [
    "https://example.com/original.mp4"
  ],
  "quality": "720p"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "kling-v4-flash-video-edit",
  "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-video-edit",
    "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 Video Edit (kling-v4-flash-video-edit)는 기존 비디오를 편집합니다
출력 화면 비율은 원본 비디오와 같습니다. 길이도 기본적으로 원본을 따르며, duration으로 지정할 수도 있습니다
텍스트 지시와 참조 이미지를 결합하여 편집할 수 있습니다
720p만 지원합니다
비동기 처리 모드이며, 반환된 작업 ID를 사용하여 상태 조회
생성된 비디오 링크는 24시간 동안 유효하며, 즉시 저장하시기 바랍니다

Flash와 Kling 4.0 선택 가이드

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

항목	Kling 4.0 Flash	Kling 4.0
출력 해상도	`720p`	`720p`, `1080p`
출력 길이	`3`~`20`초	`3`~`30`초
편집할 원본 비디오	`1`개, `3`~`20`초	`1`개, `3`~`30`초

두 모델 모두 duration=auto로 원본 비디오의 길이를 유지하거나, 각 모델의 지원 범위 안에서 출력 길이를 지정할 수 있습니다. Flash의 입력과 출력은 모두 20초 이하여야 합니다. 더 긴 비디오를 편집하거나 1080p로 출력하려면 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-video-edit",
  "prompt": "Adjust the color to warm tones and add a cinematic feel",
  "video_urls": [
    "https://example.com/original.mp4"
  ],
  "quality": "720p"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "kling-v4-flash-video-edit",
  "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-video-edit",
    "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-video-edit

필수

비디오 생성 모델 이름

사용 가능한 옵션:

kling-v4-flash-video-edit

예시:

"kling-v4-flash-video-edit"

prompt

string

필수

편집 지시, 최대 2500자

참조 구문: 프롬프트에서 <<<xxx>>>를 사용하여 이미지와 비디오를 참조할 수 있습니다. 예: <<<video_1>>> 속 인물의 코트를 <<<image_1>>>의 디자인으로 바꾼다

Maximum string length: 2500

예시:

"Adjust the color to warm tones and add a cinematic feel"

video_urls

string<uri>[]

필수

편집할 비디오 URL 배열. 1개만 지원하며 프롬프트의 <<<video_1>>>에 대응합니다

비디오 요구 사항:

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

Required array length: 1 element

예시:

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

image_urls

string<uri>[]

참조 이미지 URL 배열(스타일 참조)

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

Maximum array length: 10

예시:

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

duration

기본값:auto

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

값:

정수: 3~20초
auto: 원본 비디오와 동일한 길이

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

예시:

"auto"

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-video-edit"

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 인증이 필요합니다

본문

응답