# Kling API Status (Current)

작성: 2026-03-28
업데이트: 2026-03-30

## 현재 상태
- Phase 1 정찰/field-level documentation scope closeout 완료
- Phase 2 current production-facing model/input/payload sync closeout 가능
- production model pair는 보수적으로 `kling-v3` + `kling-v3-omni`로 정리됨
- 이미지 입력 기본전략은 우리 쪽 base64 attachment 우선으로 정리됨
- endpoint-specific image payload shape는 분리 유지됨 (`image2video`=`image`/`image_tail`, Omni=`image_list[].image_url`)
- verified generation routes are now explicit:
  - `text2video` with `kling-v3` = verified
  - `image2video` with `kling-v3` = verified
  - `omni` with `kling-v3-omni` = verified
- verified production-facing image input methods are now explicit:
  - `image2video`: top-level `image=<raw base64>`
  - `omni`: `image_list[].image_url=<raw base64>` + `type='first_frame'`
- OmniVideo breakthrough 시도 완료
- Browser Rendering `content` endpoint로 Kling 문서 접근 가능
- 핵심 문서 path 식별 완료: OmniVideo / videoExtension / callbackProtocol / rateLimits
- `multiImageToVideo` (`Reference to Video`) is now treated as a legacy/non-current route candidate, not a current production-default path

## 현재 판단
- 구조 파악은 충분히 끝났고, 현재 closeout package 기준으로는
  - **completed:** documentation-first scope, current production-facing model/input/payload sync
  - **next:** expanded Phase 3 verification
- expanded Phase 3는 이제 아래 둘을 포함한다:
  1. deeper Omni verification
  2. explicit non-Omni verification centered on current production-relevant routes (`text2video` / `image2video`)
- `reference2video` remains documented as a legacy/non-current endpoint family, but it is no longer treated as part of the current production-default route set
- 단, Phase 3는 자동 시작 대상이 아니다. **billable create가 개입되는 순간 explicit user approval가 선행 조건**이다.

## Explicit approval trigger
다음 중 하나라도 해당하면 사용자 승인 없이 진행하면 안 된다.
- 새 billable create 1건 이상 실행
- hypothesis-only payload를 billable endpoint에 전송
- 같은 immediate purpose로 2건 이상 create 비교 실행

## 관련 문서
- `docs/current/kling-current-state-summary.md`
- `docs/current/kling-priority-todo.md`
- `docs/current/kling-docs-to-implementation-workboard.md`
- `docs/current/kling-billable-create-guardrails.md`
- `docs/history/20260328_research_kling-api-phase1-final.md`
- `docs/history/20260328_research_kling-api-phase2-progress.md`
- `docs/history/20260328_research_omnivideo-breakthrough.md`