curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "kling-v2.6-motion-control",
"prompt": "A girl dancing gracefully",
"image_urls": [
"https://example.com/character.jpg"
],
"video_urls": [
"https://example.com/dance-reference.mp4"
],
"quality": "720p",
"model_params": {
"character_orientation": "image"
}
}
'{
"created": 1757169743,
"id": "task-unified-1757169743-7cvnl5zw",
"model": "kling-v2.6-motion-control",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": true,
"estimated_time": 300,
"video_duration": 8
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 22.68,
"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-v2.6-motion-control",
"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-V2.6
Kling 2.6 모션 컨트롤
- Kling 2.6 Motion Control (kling-v2.6-motion-control) 모델은 참조 이미지 + 참조 비디오를 통한 모션 기반 생성을 지원합니다
- 시스템은 참조 비디오에서 모션 궤적을 추출하여 참조 이미지의 캐릭터/오브젝트에 적용하고, 참조 비디오의 동작과 일치하는 새로운 비디오를 생성합니다
- 생성되는 비디오 길이는
character_orientation에 따라 달라집니다.image는 최대 10초,video는 최대 30초, 최소 3초입니다 - 비동기 처리 모드로, 반환된 작업 ID를 사용하여 조회하세요
- 생성된 비디오 링크는 24시간 동안 유효하며, 가능한 빨리 저장해 주세요
- 과금: 출력 비디오 초 단위로 과금하며 정수 초 단위로 반올림합니다.
1080p는720p단가의 1.6배로 과금됩니다 - 주체 요소(
element_list)는 지원하지 않으며, 비어 있지 않은element_list가 포함된 요청은 거부됩니다(빈 목록은 무시됩니다). 주체 요소가 필요하면kling-v3-motion-control을 사용하세요
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-v2.6-motion-control",
"prompt": "A girl dancing gracefully",
"image_urls": [
"https://example.com/character.jpg"
],
"video_urls": [
"https://example.com/dance-reference.mp4"
],
"quality": "720p",
"model_params": {
"character_orientation": "image"
}
}
'{
"created": 1757169743,
"id": "task-unified-1757169743-7cvnl5zw",
"model": "kling-v2.6-motion-control",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": true,
"estimated_time": 300,
"video_duration": 8
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 22.68,
"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-v2.6-motion-control",
"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"
}
}인증
##모든 인터페이스는 Bearer Token 인증이 필요합니다##
API Key 획득:
API Key 관리 페이지에서 API Key를 획득하세요
요청 헤더에 다음을 추가하세요:
Authorization: Bearer YOUR_API_KEY
본문
application/json
작업 완료 후 HTTPS 콜백 주소
콜백 시점:
- 작업 완료 (completed), 실패 (failed) 또는 취소 (cancelled) 시 트리거됩니다
- 과금 확인 완료 후 전송됩니다
보안 제한:
- HTTPS 프로토콜만 지원
- 내부 네트워크 IP 주소로의 콜백 금지
- URL 길이
2048자 이하
콜백 메커니즘:
- 타임아웃:
10초 - 실패 시 최대
3회 재시도(실패 후 각각1초/2초/4초 뒤에 재시도) - 콜백 응답 본문 형식은 작업 조회 인터페이스의 반환 형식과 동일합니다
- 콜백 주소가 2xx 상태 코드를 반환하면 성공으로 간주하며, 다른 상태 코드는 재시도를 트리거합니다
예시:
"https://your-domain.com/webhooks/video-task-completed"
응답
비디오 생성 작업이 성공적으로 생성되었습니다