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-text-to-video",
"prompt": "A cat running on a grassy field under bright sunshine",
"duration": 5,
"aspect_ratio": "16:9",
"quality": "720p"
}
'{
"created": 1757169743,
"id": "task-unified-1757169743-7cvnl5zw",
"model": "kling-v4-flash-text-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-text-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 Text to Video (kling-v4-flash-text-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초 |
1080p 출력이나 20초를 넘는 비디오가 필요하면 Kling 4.0 텍스트를 비디오로를 사용하세요.
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-text-to-video",
"prompt": "A cat running on a grassy field under bright sunshine",
"duration": 5,
"aspect_ratio": "16:9",
"quality": "720p"
}
'{
"created": 1757169743,
"id": "task-unified-1757169743-7cvnl5zw",
"model": "kling-v4-flash-text-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-text-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-text-to-video 예시:
"kling-v4-flash-text-to-video"
생성할 비디오를 설명하는 텍스트 프롬프트
참고:
- 최대
2500자
Maximum string length:
2500예시:
"A cat running on a grassy field under bright sunshine"
비디오 길이(초). 기본값은 5초입니다
범위:
3~20사이의 정수
필수 범위:
3 <= x <= 20예시:
5
비디오 화면 비율
옵션:
16:9: 가로9:16: 세로1:1: 정사각형21:9: 울트라와이드
사용 가능한 옵션:
16:9, 9:16, 1:1, 21:9 예시:
"16:9"
해상도 등급
옵션:
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-text-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