# 20260328 Research — Kling API Phase 1 Final Summary

## 결론
- Cloudflare Browser Rendering `content` endpoint를 통해 Kling 문서 접근 경로 확보 성공
- Kling 문서 사이트는 SPA/router 구조이며 `api-doc/assets/*.js` 번들 기반으로 렌더링됨
- 문서 메뉴 트리에서 핵심 API path를 직접 확인함
- 정적 HTML/정적 bundle 스캔만으로는 스펙 본문이 완전히 드러나지 않음
- 따라서 Phase 1(구조 파악/핵심 경로 식별/제한 확인)은 완료로 판단

## 확인된 핵심 경로
- `apiReference/model/OmniVideo`
- `apiReference/model/videoExtension`
- `apiReference/model/multiImageToVideo`
- `apiReference/callbackProtocol`
- `apiReference/rateLimits`

## 추가로 확인된 경로 샘플
- `quickStart` — Get Started
- `quickStart/productIntroduction/overview` — Overview
- `quickStart/userManual` — Quick Start
- `apiReference/updateNotice` — Changelog
- `apiReference` — API Reference
- `apiReference/commonInfo` — General Info
- `apiReference/rateLimits` — Rate Limits
- `apiReference/callbackProtocol` — Callback Schema
- `apiReference/model/videoGeneration` — Video Generation
- `apiReference/model/videoModels` — Models
- `apiReference/model/OmniVideo` — Video Omni
- `apiReference/model/textToVideo` — Text to Video
- `apiReference/model/imageToVideo` — Image to Video
- `apiReference/model/multiImageToVideo` — Reference to Video
- `apiReference/model/motionControl` — Motion Control
- `apiReference/model/multiElements` — Multi-elements to video
- `apiReference/model/videoExtension` — Extend Video
- `apiReference/model/lipSync` — Lip Sync
- `apiReference/model/avatar` — Avatar
- `apiReference/model/textToAudio` — Text to Audio

## 요청/제한 관찰
- `content` endpoint는 저빈도 직렬 요청에서 정상 동작
- 이전 테스트에서 `markdown`, `scrape` endpoint는 429 발생 경험 있음
- 이번 Phase 1은 요청 간 약 20~25초 간격으로 수행
- 동일 URL 재호출만으로는 본문이 추가 로드되지 않음

## 해석
- 문서 본문 데이터는 추가 런타임 로딩/내부 데이터 소스에 의존할 가능성이 높음
- Omni continuity 관련 기능은 문서 구조상 최소한 `OmniVideo`, `videoExtension`, `multiImageToVideo`로 분리되어 존재함

## 산출물 위치
- `youtube-automation/samples/kling-api/` — raw JSON/HTML/text
- `youtube-automation/docs/current/kling-api-status.md` — 현재 상태 요약
- `youtube-automation/docs/history/20260328_research_kling-api-phase1-final.md` — 최종 요약