# 20260328 Research — Kling Repackaging Strategy Validation

## 목적
리패키징 서비스/래퍼 문서를 통해 Kling 원 API 문서를 역구성하는 전략이 실제로 유효한지 검증한다.

## 결론
- **검증 결과: 유효하다.**
- 특히 Freepik 문서는 Kling 3 Omni를 OpenAPI 형식으로 노출하며, capability/async/callback/reference 구조를 상당히 상세히 보여준다.
- `mcp-kling` 문서의 capability map은 공식 Kling bundle에서 확인한 구조와 높은 정합성을 보인다.
- 따라서 이 전략은 단순 아이디어가 아니라 **실제 문서 생성에 활용 가능한 수준**으로 검증되었다.

## 검증 포인트별 결과

### 1. 실제 리패키징 서비스가 Kling capability를 노출하는가?
**예.**

#### Freepik
- `Kling 3 Omni API` overview 존재
- `Generate Std`, `Generate Std Video Reference` 등 세부 endpoint 존재
- `reference-to-video`를 별도 endpoint로 분리
- OpenAPI 형식 request/response/schema 제공
- `webhook_url` 존재 → callback 패턴 확인 가능

검증 결과:
- 단순 마케팅 페이지가 아니라 **실제 구현 가능한 API 문서** 수준임

### 2. 공식 Kling 구조와 대응되는가?
**예. 상당히 잘 대응된다.**

공식 구조(bundle에서 확보):
- `OmniVideo`
- `videoExtension`
- `multiImageToVideo`
- `callbackProtocol`
- `rateLimits`

외부 문서/래퍼에서 대응되는 구조:
- `Kling 3 Omni`
- `reference-to-video`
- `callback/webhook`
- capability map: `Multi-Image to Video`, `Video Extension`, `Callback Protocol`

검증 결과:
- capability 수준에서는 높은 정합성
- naming은 wrapper에 따라 다를 수 있으나, 구조 축은 충분히 매핑 가능

### 3. 실사용 문서를 만드는 데 필요한 정보가 나오나?
**부분적으로 예.**

확보 가능한 것:
- capability map
- endpoint 분리 방식
- async task 생성/조회 흐름
- callback/webhook 필드
- input parameter 범주
- video reference 관련 사용 패턴

아직 부족한 것:
- 원본 Kling 고유 필드명 확정
- 공식 rate limit 수치
- callback payload 원문 전체
- 원본 요청/응답 예제의 정확성

즉:
- **실용적인 API 문서 초안 작성은 가능**
- 단, `공식 확인`과 `wrapper 기반 추정`을 구분해야 함

## 핵심 검증 사례

### Freepik에서 확인된 강한 신호
- `Kling 3 Omni API` overview에서 다음 capability 명시:
  - text-to-video
  - image-to-video
  - reference-to-video
  - multi-shot
  - element consistency
  - audio options
  - async processing
- `generate-std-video-reference` 문서에서:
  - `video_url` required
  - `@Video1` 참조 방식
  - `webhook_url`
  - request schema / response schema

의미:
- Kling continuity/참조 기반 사용 방식의 실사용 구조를 역추론하는 데 매우 유효

### mcp-kling에서 확인된 강한 신호
- capability map에 다음 항목 존재:
  - Text to Video
  - Image to Video
  - Multi-Image to Video
  - Video Extension
  - Callback Protocol
  - Account Information Inquiry

의미:
- 공식 Kling bundle path와 높은 정합성
- wrapper/역문서가 공식 구조를 강하게 반영하고 있을 가능성 높음

## 냉정한 평가

### 이 전략의 장점
1. 공식 본문 추출이 막힌 현재 상황에서 가장 현실적인 우회책
2. capability map과 async 구조를 빠르게 복원 가능
3. OpenAPI/SDK/래퍼 예제로 실제 요청 흐름을 재구성 가능

### 한계
1. 원본 Kling과 필드명이 다를 수 있음
2. 공급자별로 기능 범위가 다를 수 있음
3. 문서 작성 시 `확인됨 / wrapper 기준 / 추정` 구분이 필수

## 최종 판단
- **리패키징 문서 기반 역구성 전략은 실제로 쓸 만하다.**
- 지금 단계에서 `Kling API 초안 문서`를 만들 때,
  - 공식 bundle 구조
  - Freepik OpenAPI
  - mcp-kling capability map
을 합치는 방식은 충분히 타당하다.
- 다만 결과 문서는 반드시 레이블링해야 한다:
  - 공식 구조 확인
  - wrapper 문서 기반
  - 추정/보강 필요