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-image-to-video",
"prompt": "The person in the image slowly turns their head and smiles",
"image_start": "https://example.com/portrait.jpg",
"duration": 5,
"quality": "720p"
}
'{
"created": 1757169743,
"id": "task-unified-1757169743-7cvnl5zw",
"model": "kling-v4-flash-image-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": 31.96,
"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-image-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 Image to Video (kling-v4-flash-image-to-video)는 이미지에서 비디오를 생성합니다
- 첫 프레임만 지원하며, 마지막 프레임과 중간 프레임은 지원하지 않습니다
- 화면 비율은 첫 프레임 이미지에 의해 결정되며,
aspect_ratio를 받지 않습니다 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초 |
| 프레임 제어 | 첫 프레임 image_start만 지원 | 첫 프레임, 선택 사항인 마지막 프레임 image_end, 최대 8개의 중간 프레임 keyframes |
첫 프레임과 마지막 프레임 사이의 전환, 중간 키프레임 제어, 1080p 출력 또는 20초를 넘는 비디오가 필요하면 Kling 4.0 이미지를 비디오로를 사용하세요. Flash에는 첫 프레임만 전달하고 image_end와 keyframes는 전달하지 마세요.
Flash는 별도의 모델 ID를 사용합니다. 전환할 때 model, quality, duration을 함께 확인하세요. 실제 요금은 선택한 Flash 모델의 현재 가격과 작업의 최종 정산 결과에 따라 결정됩니다.
POST
/
v1
/
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-image-to-video",
"prompt": "The person in the image slowly turns their head and smiles",
"image_start": "https://example.com/portrait.jpg",
"duration": 5,
"quality": "720p"
}
'{
"created": 1757169743,
"id": "task-unified-1757169743-7cvnl5zw",
"model": "kling-v4-flash-image-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": 31.96,
"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-image-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"
}
}인증
모든 API는 Bearer Token 인증이 필요합니다
API Key 받기:
API Key 관리 페이지를 방문하여 API Key를 받으세요
요청 헤더에 추가:
Authorization: Bearer YOUR_API_KEY
본문
application/json
비디오 생성 모델 이름
사용 가능한 옵션:
kling-v4-flash-image-to-video 예시:
"kling-v4-flash-image-to-video"
이미지-비디오 변환을 위한 첫 프레임 이미지 URL (필수)
참고:
- 이미지 크기: 최대
10MB - 지원 형식:
.jpg,.jpeg,.png - 이미지 해상도: 너비 및 높이 >=
300px, 종횡비1:2.5~2.5:1 - 이미지 URL은 서버에서 직접 접근할 수 있거나, 접근 시 직접 다운로드되어야 합니다
예시:
"https://example.com/portrait.jpg"
생성할 비디오를 설명하는 텍스트 프롬프트
참고:
- 최대
2500자
Maximum string length:
2500예시:
"The person in the image slowly turns their head and smiles"
비디오 길이(초). 기본값은 5초입니다
범위:
3~20사이의 정수
필수 범위:
3 <= x <= 20예시:
5
해상도 등급
옵션:
720p만 지원합니다
사용 가능한 옵션:
720p 예시:
"720p"
작업 완료 시 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"
응답
비디오 생성 작업이 성공적으로 생성되었습니다
작업 생성 타임스탬프
예시:
1757169743
작업 ID
예시:
"task-unified-1757169743-7cvnl5zw"
실제 사용된 모델 이름
예시:
"kling-v4-flash-image-to-video"
작업 유형
사용 가능한 옵션:
video.generation.task 작업 진행률 (0-100)
필수 범위:
0 <= x <= 100예시:
0
작업 상태
사용 가능한 옵션:
pending, processing, completed, failed 예시:
"pending"
비디오 작업 세부 정보
Show child attributes
Show child attributes
작업 출력 유형
사용 가능한 옵션:
text, image, audio, video 예시:
"video"
사용량 및 과금 정보
Show child attributes
Show child attributes