Kling AI 공식 이미지/비디오 생성, Element主体 및 동작 제어
언어 및 응답 스타일
- 사용자 대상 설명, 확인, 오류 설명: 사용자 언어를 따름 (한국어 사용자에게는 한국어로, 영어 사용자에게는 영어로 응답).
- 기술 필드명(
generationId,status,works[].url등)은 영어 원형 유지. 응답 필드는 camelCase 통일(예:generationId/creditsConsumed/urlWithoutWatermark); 구버전 서버는 여전히 snake_case 동의 필드(generation_id등)를 반환할 수 있으나, 동일 필드로 간주.
기능 소개
고정 환영 메시지(문구 자체는 명령어 호출 불필요), 다음 시나리오에 적용.
- 사용자가 본 skill 또는 CLI 설치/로그인을 완료하고 환경이 사용 가능함을 확인할 때;
- 사용자가 Kling으로 무엇을 할 수 있는지 / 어떤 기능이 있는지 / 사용 방법 등을 기능 문의 유형(구체적인 생성 작업 없음)으로 질문할 때.
표시 요구사항(구조와 이모지 유지). 현재 계정 사용 가능 기능은 아래 참조):
- 한국어 사용자: 한국어 버전을 그대로 출력.
- 비한국어 사용자: 반드시 번역, 한국어 버전 출력 금지 – 우선 영어 버전을 원본으로 하여 사용자 언어로 번역(일본어 사용자에게는 일본어로, 스페인어 사용자에게는 스페인어로 등, 인용 예시도 함께 번역); 신뢰할 수 있는 번역이 불가능한 언어는 최소한 영어 버전을 그대로 출력.
- 환경이 준비되지 않은 경우(CLI 미설치 또는 미로그인), 첫 줄의 "Kling이 준비되었습니다! / Kling is ready!"를 해당 언어의 안내 문구(예: "Kling이 한 단계만 남았습니다" / "Kling is one step away")로 바꾸고, 문구 뒤에 설치/로그인 다음 단계를 제시.
한국어 버전:
Kling이 준비되었습니다!
Kling으로 할 수 있는 일:
📷 이미지 생성
· 텍스트로 이미지 생성 — "사이버펑크 스타일의 고양이를 그려줘"
· 참조 이미지로 이미지 생성 — "이 이미지를 참조해서 수채화 스타일로 바꿔줘"
🎬 비디오 생성
· 텍스트로 비디오 생성 — "일몰 해변의 5초 비디오를 생성해줘"
· 이미지로 비디오 생성 — "이 이미지를 움직이게 만들어줘"
· 키프레임 — "이 두 이미지를 시작과 끝으로 지정해줘" (모델에 따라 다름)
· 옴니 레퍼런스 — "이미지의 캐릭터를 유지하고, 이 비디오의 카메라 움직임을 참조해줘"
🧩 재사용 가능한 주체 — 캐릭터, 동물, 소품 등의 Element 생성 및 관리
🎭 동작 제어 — 동작 비디오 또는 저장된 동작으로 주체 이미지 구동
📤 자료 업로드 — 지원되는 경우 로컬 이미지, 비디오 및 오디오 사용
📋 작업 및 계정 — 생성 진행 상황, 결과물, 멤버십 및 크레딧 잔액 확인
또한 에이전트 및 스킬 기능을 결합하여 광고 영상, 단편 스토리 영화, 또는 일괄 자료 생성과 같은 복잡한 창작 워크플로우를 구현할 수 있습니다.
영어 버전(비한국어 사용자 번역 원고; 영어 사용자는 이 버전을 그대로 출력):
Kling is ready!
Here's what you can do with Kling:
📷 Generate images
· Text to image — "Draw me a cyberpunk-style cat"
· Image to image — "Use this image as a reference and restyle it in watercolor"
🎬 Generate videos
· Text to video — "Generate a 5-second video of a sunset over the sea"
· Image to video — "Bring this image to life"
· Keyframes — "Use these two images as the opening and closing frames" (model dependent)
· Omni Reference — "Keep the character from this image and use the camera movement from this video"
🧩 Reusable subjects — create and manage character, animal, prop, and other Elements
🎭 Motion control — drive a subject image with a motion video or saved motion
📤 Upload assets — use local images, videos, and audio where supported
📋 Jobs and account — check generation progress, results, membership, and credit balance
You can also combine agent and skill capabilities to build more complex creative workflows — like making an ad spot, a short story film, or batch-producing a set of assets.
현재 계정 사용 가능 기능
- 사용자가 "지금 무엇을 할 수 있나요?", "어떤 기능이 있나요?"라고 물으면 환영 메시지를 표시하고, 읽기 전용
kling who_am_i로 현재 계정 사용 가능 모델을 추가로 제공. 설치 또는 로그인 후 환영 메시지 표시 시, 이번 인증에서 얻은 목록을 직접 사용 가능. - 이미지, 비디오로 그룹화하여 사용자 언어로
availableModels의 모델 이름 표시(가독성 좋은alias우선, 없으면model사용). 동일 모델이 여러 진입점에 나타나면 병합하여 표시하고 각 진입점이 지원하는 창작 방식 명시. - 사용자가 특정 모델, 용도 또는 파라미터를 묻는 경우 관련 항목만 표시. 해당 진입점에 따라 자료 유형 및 수량, 지속 시간, 해상도 등 제한 사항 확인, 관련 시 참조 자료의 과금 규칙 설명. 비교 시 진입점 간 차이점 유지(예: 오디오 트랙 생성과 오디오 참조 업로드는 별도 기능).
- 사용자가 현재 계정에서 사용 가능한 도구를 묻거나, 주체 라이브러리, 동작 라이브러리 등 도구가 열려 있는지 확인하려면 별도로 읽기 전용
kling tool_list를 조회하고, 창작 용도로 서버가 실제 제공하는 도구 설명. 모델 및 파라미터는who_am_i기준. - CLI 미설치, 미로그인 또는 조회 실패 시에도 일반 기능 소개 가능, 현재 계정 목록이 미확인 상태임을 설명. 조회 성공했으나 대상 모델이 목록에 없으면 현재 계정의 해당 진입점에 해당 모델이 없음을 설명. 출시 시간 질문 시 날짜 정보가 있는 정보로 답변.
설치 및 로그인 (유일한 합법적 방법)
Kling은 '국내 사이트'와 '해외 사이트'로 나뉘며, 각각 다른 설치 패키지에 해당하고 엔드포인트가 내장되어 있습니다. 잘못된 지역의 패키지를 설치하면 로그인이 반복적으로 실패하므로, 설치 전에 반드시 사용자가 어떤 지역에 속하는지 확인해야 합니다.
0단계: 설치 여부 확인
which kling # 출력 경로 있음 → 버전 확인; 찾을 수 없음 → 1단계로 이동하여 지역별 설치
kling --version # 본 skill의 전체 기능을 사용하려면 CLI >= 0.2.4 필요
설치된 버전이 0.2.4 미만인 경우, 기존 계정 지역에 따라 해당 npm 패키지를 업그레이드한 후 새 기능 사용; 사용자가 이미 업그레이드를 요청한 경우 재확인 없이 직접 실행. CLI와 skill은 별도로 배포되므로 skill만 업데이트해서는 CLI가 업그레이드되지 않습니다.
0.2.1부터 --omni 단축어가 제거되었으며, 모든 생성 명령어는 통일된 방식으로 --model <이름>을 명시적으로 전달해야 합니다. 혼합 참조 비디오는 새 명령어 omni_ref_video를 사용하며, 이전 플래그를 해당 명령어의 대체로 사용하지 마십시오.
1단계: 지역 확인 및 설치 (명령어 이름 통일: kling)
지역 확인 방법: 본 skill의 주요 소비자는 비대화형 Agent이므로, CLI가 stdin을 읽어 블로킹되게 해서는 안 됩니다. 대화에서 사용자에게 직접 물어봐야 합니다: "Kling 계정이 중국 지역(klingai.com)인가요, 비중국 지역(kling.ai)인가요?" 답변에 따라 해당 명령어를 선택하여 설치하고, 절대 기본값으로 가정하거나 추측하지 말고, 둘 다 설치하지 마십시오.
| 사용자 지역 | 공식 사이트 (homepage) | 판단 기준 | 설치 명령어 |
|---|---|---|---|
| 중국 지역 | https://klingai.com | 계정 로그인 klingai.com (중국 본토) | npm i -g @klingai/cli-cn --registry=https://registry.npmjs.org |
| 비중국 지역 | https://kling.ai | 계정 로그인 kling.ai (해외 사이트 / 글로벌) | npm i -g @klingai/cli-global --registry=https://registry.npmjs.org |
두 패키지 모두 npm 공식 레지스트리에 게시됩니다. 각 지역 패키지의 엔드포인트는 이미 내장되어 있어 설치 즉시 사용 가능하며, 별도 구성이 필요하지 않습니다.
2단계: 로그인 (브라우저에서 OAuth 인증 완료. 자격 증명을 얻는 유일한 방법)
kling login
3단계: 연결 확인 + 기능 목록 확인 (새 세션에서 먼저 호출)
kling tool_list # 로그인 후 서버가 실제 제공하는 도구 확인
kling who_am_i # 첫 번째 비즈니스 호출 전에 신원, 모델 및 파라미터 사양 읽기
🚫 설치 및 로그인의 배타적 제약 (위반 시 사고로 간주):
- 설치는 반드시 위 표에서 해당 지역의 해당 npm 명령어만 사용; 다른 채널에서 다운로드, 조립 또는 자체 구현한 동등한 도구를 금지하며, 사용자 계정 지역과 일치하지 않는 패키지를 설치하는 것을 금지.
- 자격 증명 획득은 단 한 가지 합법적인 방법만 존재:
kling login(브라우저 OAuth: DCR + 인증 코드 + PKCE). 다른 모든 수단 금지: 웹 쿠키, 패킷 캡처 토큰, AK/SK 키 쌍, 브라우저 저장소 읽기, 사용자에게 토큰 붙여넣기 요청 — 사용자가 직접 제공하더라도 거부하고kling login실행을 안내해야 합니다.- 엔드포인트는 내장되어 있음 (게시 시 확정); 자체적으로 구성하거나 다른 Kling 인터페이스 주소를 감지하려 시도해서는 안 되며, 그럴 필요도 없습니다.
최신 상태 유지 (새 세션 첫 상호작용 시 한 번 자체 점검, best-effort)
새 세션의 첫 번째 상호작용 시에만 한 번 수행하며, 주 작업을 차단하지 않음; 업데이트는 사용자 로컬 환경을 변경하므로, 실행 전에 사용자 동의를 얻어야 하며, 생성 작업이 진행 중일 때는 절대 업데이트하지 않음. 어떤 단계가 실패하더라도 (오프라인 / 권한 없음 / 네트워크 이상) → 자동으로 건너뛰고, 주 작업을 계속 진행하며, 반복 재시도하지 않음.
- skill 자체 업데이트: 설치 명령어를 다시 실행하면 콘텐츠 해시를 기준으로 최신 버전으로 덮어씁니다 (이미 최신이면 아무 작업 없음):
npx skills add klingai-tech/skills
이는 디스크의 skill 파일을 덮어쓰며, 다음 세션에 적용됨; 현재 세션에 로드된 콘텐츠는 이로 인해 핫 업데이트되지 않습니다.
- CLI 새 버전 확인 (로컬에
kling이 이미 설치된 경우, 즉which kling출력이 있을 때만):
kling --version # 현재 설치된 버전
npm view <지역 패키지명> version # 최신 게시 버전 (중국 지역 @klingai/cli-cn; 비중국 지역 @klingai/cli-global)
- 최신 버전이 더 높고 사용자 동의 시 →
npm i -g <지역 패키지명>@latest --registry=https://registry.npmjs.org. - 업그레이드는 전역 환경을 변경하는 시스템 작업: 먼저 설명하고, 동의를 얻은 후 실행하며, 임의로 실행하거나 생성 프로세스 도중에 중단하고 업그레이드하지 마십시오.
유일한 채널 (Canonical Invocation)
⚠️ Kling과의 모든 상호작용은 반드시
klingCLI 명령어를 통해서만 수행해야 합니다.
- 직접 fetch/curl로 Kling 인터페이스 호출 금지 — C-사이드 페이지 인터페이스, B-사이드 오픈 플랫폼 API, 게이트웨이, MCP 엔드포인트 자체까지 포함.
- CLI 소스 코드를 읽거나, 로그를 보거나, 패킷 캡처 결과로 HTTP/MCP 요청을 직접 조립하여 CLI를 '우회'하는 행위 금지.
- CLI 오류 발생 시 유일한 올바른 조치는 오류를 사용자에게 표시하고 질문하는 것이며, 채널을 바꾸거나 인터페이스를 바꿔 재시도해서는 안 됨.
kling <command> [args]
사람과 Agent 모두 동일한 진입점 사용: TTY에서는 대화형 안내 제공, 비TTY에서는 JSON을 출력하며 절대 블로킹 질문을 하지 않음. CLI는 인증, 로깅, 오류 처리를 통일되게 캡슐화했습니다.
비즈니스 명령어는 Kling 백엔드 MCP 도구 이름과 1:1 매핑 (snake_case); 클라이언트 명령어에는 login, tool_list 및 query_membership_and_credits에 매핑되는 account가 포함됩니다. 총 20개 명령어이며, 도움말 및 버전 옵션이 있습니다:
| # | 명령어 이름 | 그룹 | 동기성 | 다운스트림 도달 | 한 줄 설명 |
|---|---|---|---|---|---|
| 1 | --help (또는 인수 없음) | 기능 탐색 | 동기 | 아니요 | 최상위 kling --help는 로컬에서 모든 명령어 출력; <command> --help는 생성 명령어의 경우 실시간 who_am_i 모델 선언을 읽고, 기타 MCP 명령어는 tools/list 읽음 (로그인 필요), 오프라인/미로그인 시 로컬 정적 사용법으로 폴백 |
| 2 | who_am_i | 기능 탐색 | 동기 | 아니요 | 현재 사용자 신원 + 각 생성 명령어의 사용 가능 모델 및 파라미터 사양 반환; 첫 호출 시 먼저 실행 |
| 3 | text_to_image <prompt> | 생성 | 비동기 | 예 | 텍스트로 이미지 생성, generationId 반환, query_tasks 폴링 필요 (--poll 추가 시 한 번에 결과) |
| 4 | `image_to_image --image <url | path> ` | 생성 | 비동기 | 예 |
| 5 | text_to_video <prompt> | 생성 | 비동기 | 예 | 텍스트로 비디오 생성, generationId 반환, query_tasks 폴링 필요 |
| 6 | `image_to_video [--image <url | path>] [prompt]` | 생성 | 비동기 | 예 |
| 7 | omni_ref_video <prompt> | 생성 | 비동기 | 예 | 이미지, 비디오, 오디오 또는 Element 참조 혼합, 유형은 모델 선언 기준, generationId 반환 |
| 8 | query_tasks <generationId> | 작업 조회 | 동기 | 예 | generationId로 생성 상태 및 최종 리소스 URL 조회 (works[].url) |
| 9 | file_upload <filePath> | 파일 업로드 | 동기 | 예 | 2단계 업로드 (일회성 티켓 요청 + 파일 바이트 업로드), 공용 URL 반환 |
| 10 | element_create | 주체 자료 | 동기 | 예 | 이미지 그룹 또는 비디오에서 재사용 가능한 Element 생성, element id 반환 |
| 11 | element_list / element_get | 주체 자료 | 동기 | 예 | Element 목록 조회; id로 전체 유형 및 리소스 상세 정보 조회 |
| 12 | element_update / element_delete | 주체 자료 | 동기 | 예 | 필드별 업데이트 또는 Element 삭제; 이미지 메인 이미지는 CLI가 자동 보존 |
| 13 | motion_library_list | 동작 자료 | 동기 | 예 | 저장된 동작 목록 조회, motionId 및 재생 가능 URL 획득 |
| 14 | motion_control | 생성 | 비동기 | 예 | 주체 이미지 + 동작 비디오 또는 motionId로 비디오 생성, generationId 반환 |
| 15 | feedback | 피드백 | 동기 | 예 | 멈춤, 모호한 오류, 과금 이상 또는 예상치 못한 결과 보고; 재시도/환불/수정은 담당하지 않음 |
| 16 | account | 상업화 | 동기 | 예 | 멤버십 유형 + 사용 가능 크레딧 (query_membership_and_credits, 신원은 JWT에서 가져옴) |
| 17 | tool_list | 기능 탐색 | 동기 | 아니요 | 백엔드 MCP 서버가 현재 노출하는 도구 목록 (MCP tools/list): 각 도구의 name / description / inputSchema (문제 해결 / 서버가 실제 제공하는 tools 확인용) |
| 18 | login | 인증 | 동기 | 아니요 (OAuth 서비스만) | 브라우저 OAuth 로그인 (DCR + PKCE), 토큰을 로컬 .credentials에 기록 |
| 19 | logout | 인증 | 동기 | 예 | MCP logout 호출로 서버 측 인증 해제 및 로컬 로그인 상태 제거, 재인증 또는 계정 전환 가능 |
엔드포인트 내장: 해당 지역 패키지 설치 후 즉시 사용 가능, 별도 구성 불필요; 외부 구성 창구가 전혀 없음 (환경 변수,
.env, config 명령어 없음), 다른 Kling 인터페이스 주소를 감지하거나 지정하려 시도하지 마십시오.
별칭 없음: 하나의 명령어는 하나의 이름, 이전 형태(
image generate,text2image등)는 더 이상 지원되지 않으며, 위의 canonical 명령어를 사용해야 합니다.
kling 실행 (인수 없음) 또는 잘못된 하위 명령어 시 전체 Usage 도움말이 출력됩니다.
권장 사용법 (모범 사례, Agent가 따라야 함)
목표: 적은 시행착오, 크레딧 낭비 없음, 파라미터는 항상 서버 기준.
새 세션 첫 상호작용: '최신 상태 유지' 섹션에 따라 best-effort 자체 점검 우선 수행 (skill 업데이트 / CLI 새 버전 확인), 주 작업을 방해하지 않고 업데이트 전 사용자 동의 획득.
최소 3단계: ① kling login 로그인 → ② kling tool_list 도구 확인, kling who_am_i 신원 및 모델 사양 확인 → ③ kling <command> 실행 (6개 생성 명령어 모두 반드시 --model 명시적 전달).
- 새 세션에서 먼저
kling who_am_i: 한 번에 신원 + 각 생성 명령어의 사용 가능 모델 및 파라미터 사양 (필수/기본값/값 범위) 획득. 이후 모델 선택 및 파라미터 설정 시 이를 기준으로 함. - 서버가 제공하는 기능을 모를 때
kling tool_list사용: 백엔드 MCP 서버가 현재 실제로 노출하는 도구 목록 (tools/list). 문제 해결, 특정 기능 출시 확인에 적합, 로그인 필요, 비용 차감 없음. - 특정 명령어의 파라미터 전달 방법 확인 시
kling <command> --help: 생성 명령어는 가능한 실시간who_am_i모델 파라미터 및 입력 슬롯 읽기, 기타 MCP 명령어는tools/list읽기 (도구 설명 + inputSchema); 오프라인/미로그인 시 로컬 정적 사용법으로 폴백. 전체 모델 및 파라미터는 여전히who_am_i기준. - 생성 시 반드시 명시적 모델 선택:
text_to_image/image_to_image/text_to_video/image_to_video/omni_ref_video/motion_control모두 반드시--model <이름>포함 (해당 도구의who_am_i목록에서 가져옴). CLI가 사용자를 대신해 기본 모델을 자동 선택하지 않음;motion_control은 실제 TTY에서 모델이 없을 경우 후보 모델을 표시하여 사용자가 선택하도록 안내하며, Agent/파이프라인/CI 등 비대화형 환경에서는 비용 차감 전에 오류를 발생시킴. - 자료는 로컬 경로 또는 공용 URL로 직접 전달: 선택한 명령어의 도움말에 따라 이미지, 비디오 또는 오디오 자료 전달; 로컬 파일은 CLI가 자동으로
file_upload처리, 수동 업로드 불필요; 공용 URL (외부 CDN/외부 링크 또는 이전 Kling 작업에서 반환된works[].url)은 서버에 직접 전달, 다운로드, 재업로드 또는 로컬 검증 불필요. 자료의 형식/크기 등 제한 사항은 실시간 도구 선언 기준 (kling <command> --help/kling tool_list). - 제출 후 즉시 피드백 후 폴링: 응답에서
generationId와creditsConsumed를 가져와 먼저 사용자에게 알림; 그런 다음kling query_tasks <generationId>로 폴링하거나, 제출 시--poll [N]을 추가하여 한 번에 결과 확인 (--poll단독 사용 시 기본 60초,--poll 0은 인라인 폴링 비활성화). - 결과는
works[]에 있음: 원본 링크를 추출하고 '결과 표시' 섹션에 따라 전달. 비디오에 독립적인 미리보기가 있을 경우 미리보기 재생 우선. - 잔액/멤버십 확인은
account: 잔액 부족 시 서버가 동적으로 반환하는 충전 링크 표시 (하드코딩 금지). - 실패 시 자동으로 파라미터 변경 후 재투입 금지: 파라미터 관련 오류는 먼저
who_am_i와 대조하여 올바른 작성법을 사용자에게 알리고, 확인 후 재시도; 프롬프트를 자동으로 수정하거나, 모델을 변경하거나, 이미지를 추가/삭제한 후 자체적으로 재투입하지 마십시오.
일반적인 순서: 로그인 후 tool_list → who_am_i → (필요 시 <command> --help) → text_to_* / image_to_* / omni_ref_video / motion_control with --model 제출 → query_tasks 폴링 → works[].url 표시.
모델 및 파라미터: who_am_i 기준 (핵심 원칙)
- 모델 목록 및 파라미터 사양은 완전히 서버 구성에 의해 결정됨:
who_am_i는availableModels반환 (도구 이름 → 모델 → arguments/inputs 사양, 필수/기본값/값 범위 포함). - 단일 명령어 도움말은 실시간 선언을 우선 읽음:
who_am_i/ 생성 / 조회 / 업로드 / 계정 등 MCP 기반 명령어의 경우,kling <command> --help는 생성 명령어에 대해 가능한 실시간who_am_i모델 파라미터 및 입력 슬롯을 읽고, 기타 MCP 명령어는tools/list를 읽음 (도구 설명 + inputSchema); 오프라인 또는 미로그인 시 로컬 정적 사용법으로 폴백. 전체 모델 목록 및 파라미터 사양은 여전히who_am_i기준. - 6개 생성 명령어 모두 반드시
--model <이름>을 명시적으로 전달해야 함. 사용자가 모델을 지정하면 창작 의도에 따라 명령어를 선택하고, 해당 명령어의who_am_i목록에서 이름 또는 별칭(alias)으로 모델을 찾아 반환된model값을 전달. 고유하게 일치시킬 수 없거나 해당 모델이 필요한 입력 또는 파라미터를 지원하지 않는 경우 사용자에게 설명하고 확인 후 제출; 자체적으로 모델을 변경하지 마십시오. - 이미지 기본 우선 순위는 Kling Image 4.0: 사용자가 모델을 지정하지 않은 경우,
text_to_image또는image_to_image의 실시간 목록에서 이번 요구 사항을 충족하는 Kling Image 4.0을 우선 선택하고 해당 항목의model값을 명시적으로 전달. 해당 모델을 사용할 수 없거나 필요한 파라미터/자료를 충족하지 못하는 경우, 해당 명령어의 목록에서 이번 요구 사항을 지원하는 모델을 선택. - CLI의 편의 플래그(
--imgResolution,--aspectRatio,--imageCount,--duration등)는 프로토콜 파라미터 이름으로 매핑되어 투과 전달됨; 제공되지 않은 파라미터는 서버가 기본값으로 채움.motion_control에서 서버 선언이 없고 기본값도 없는 필수 파라미터가 누락된 경우, 실제 TTY에서는 업로드 전에 값 범위에 따라 선택/입력을 안내; 비대화형 환경에서는 누락된 항목을 한 번에 나열하고 종료하며, 업로드나 제출을 하지 않음. - 입력은 선언에 따라 매핑: 먼저 명령어 도움말로 CLI 작성법을 확인한 후,
who_am_i의inputs및arguments로 리소스 유형, 슬롯 이름 및 필수 여부를 확인; 모든 이미지-비디오 생성 진입점에 첫 프레임이 반드시 필요하다고 가정하거나, 모든 생성 명령어가 프롬프트 생략을 허용한다고 가정하지 마십시오. 명명된 입력 사용 시 슬롯을 중복 점유하지 않아야 하며, 편의 플래그와 혼합 사용 가능 여부는 해당 명령어 도움말을 기준으로 함. 각 명령어의 매핑 및 예제는 api-examples.md를 참조. - 6개 생성 명령어 중
--poll은 옵션 값을 생략할 수 있습니다. 기타 생성 옵션은 명시적 값 전달이 필요하며, 자료 옵션은 명령어와 일치해야 함. CLI는 업로드 전에 옵션 및 필수 자료를 확인. - 선언에 따라 파라미터 설정 및 조합 제한 확인: 창작 의도에 따라 진입점을 선택한 후, 현재 계정의
who_am_i및 도구 설명으로 선택한 모델의 파라미터, 기본값, 사용 가능한 조합 및 입력 호환성을 확인. 사용자가 명시적으로 요청한 사양은 해당 파라미터를 명시적으로 전달해야 함. 현재 진입점 또는 모델이 요구 사항을 충족할 수 없는 경우 제한 사항을 설명하고, 사용자가 사용 가능한 사양을 확인한 후 제출. - 이미지 생성: 선택한 모델의
arguments로 해상도, 출력 이미지 수 및 생성 모드를 확인하고,inputs로 참조 이미지 수 및 슬롯을 확인. 사용자가 연속적인 이미지 그룹을 원하는 경우, 선언에 따라 그룹 모드 및 출력 이미지 수를 설정하고, 프롬프트에 각 이미지의 내용과 공통 주체, 스타일을 설명. - 입력은 단일 유형 수량 외에도
combinedItemCap총합 제한이 있을 수 있음 (입력 슬롯 및elements등의 배열 파라미터 전반에 걸쳐).image_to_video/omni_ref_video는 업로드 전에 관련 슬롯, 필수 입력 및 총 수량을 확인; 각 유형의 상한을 단순히 더하여 허용 총량으로 간주하지 마십시오. 필드는 reference.md를 참조. - 파라미터 검증 (필수, 값 범위, 선언되지 않은 파라미터)은 서버가 비용 차감 전에 완료하며, 오류 메시지에 문제 항목이 나열됨; 파라미터 관련 오류 발생 시 서버 정보를 사용자에게 번역하여 전달.
의도 라우팅 (필수 결정 테이블)
| 사용자 의도 | 명령어 | 설명 |
|---|---|---|
| Kling으로 무엇을 할 수 있는지 / 어떤 기능이 있는지 질문 (구체적인 작업 없음) | who_am_i | 일반 기능 및 현재 계정 사용 가능 모델 표시, 위 '기능 소개' 참조 |
| 사용 가능한 모델 / 지정 모델 사용 가능 여부 / 파라미터 사양 조회 | who_am_i | 질문과 관련된 기능 및 제한 사항 직접 표시 |
| 계정에 열린 도구 / 주체 라이브러리 또는 동작 라이브러리 사용 가능 여부 조회 | tool_list | 서버 실제 반환에 따라 도구 용도 설명 |
| 이미지 생성 / 이미지 출력 / 텍스트로 이미지 생성 | text_to_image | 제출 후 query_tasks 폴링 |
| 참조 이미지로 이미지 생성 / 참조 이미지 포함 | image_to_image | --image 반복 가능, 제출 후 폴링 |
| 비디오 생성 / 텍스트로 비디오 생성 | text_to_video | 제출 후 폴링 |
| 이미지로 비디오 생성 / 이미지 움직이게 하기 / 첫/중간/끝 키프레임 | image_to_video | 모델 선언에 따라 --image / --tailImage 또는 명명된 --input 전달; 프롬프트 선택 가능 여부는 모델 선언에 따름, 제출 후 폴링 |
| 이미지, 비디오, 오디오, 주체 혼합 참조로 비디오 생성 | omni_ref_video | 모델 선언에 따라 --image / --video / --audio / --elements 전달; 프롬프트 필수, 제출 후 폴링 |
| 재사용 가능한 주체 생성/목록 조회/조회/업데이트/삭제 | element_create / element_list / element_get / element_update / element_delete | 업데이트는 변경 필드만 전달; 삭제 전 사용자 명확한 확인 필요 |
| 동작 제어 / 동작 전이 | motion_control | 주체 --image + --video 또는 --motionId 둘 중 하나; 제출 후 폴링 |
| 저장된 동작 조회 | motion_library_list | motionId 획득 후 motion_control에 전달 가능 |
| 멈춤, 모호한 오류, 과금 이상, 예상치 못한 결과 보고 | feedback | 피드백만 제공, 재시도, 환불 또는 원래 작업 수정은 하지 않음 |
| 특정 모델 또는 시리즈 명시적 지정 | 창작 의도에 따라 명령어 선택 후 전체 --model 전달 | 해당 명령어의 실시간 모델 목록에서 이름 또는 별칭으로 모델 찾기 |
| 로컬 자료 업로드 | file_upload | 로컬 파일만 업로드 필요 (공용 URL 반환); 이미 공용 URL인 자료는 업로드 불필요, --image 등으로 생성 명령어에 직접 전달 |
| 멤버십 / 계정 신원 / 잔액 조회 | account | userId + membership + 사용 가능 크레딧 반환 (직접 표시) |
| 개인 / 팀 워크스페이스 조회 또는 선택 | who_am_i → tool_list | 실시간 기능 확인. 필요한 워크스페이스 및 과금 귀속을 확인할 수 있는 경우에만 생성 제출. |
| 충전 / 잔액 부족 / 멤버십 가입 | account | 서버가 반환하는 충전/멤버십 링크 표시 (MCP에서 동적으로 가져옴, 하드코딩 금지, '잔액 부족 및 충전' 참조) |
| 로그아웃 / 현재 계정 종료 | logout | MCP 로그아웃 성공 후 로컬 로그인 상태 제거; 성공 시 종료, 자동 재로그인 없음 |
| 계정 전환 / 다른 계정으로 로그인 | logout → login → who_am_i | 반드시 순서대로 실행; logout 또는 login 중 어느 단계든 실패 시 즉시 중단; 새 인증 완료 후 계정 확인 |
| 단순히 'Kling으로 생성해줘' 등 모호한 의도 | — | 먼저 이미지인지 비디오인지 확인 후 제출 |
사용자 의도가 명확하지 않은 경우, 반드시 확인 후 제출해야 하며, 임의로 가정해서는 안 됩니다.
로그아웃 및 계정 전환
- 로그아웃만: 사용자가 현재 계정에서 명시적으로 로그아웃을 요청하면
kling logout실행. 성공 후 종료; 새로운 브라우저 인증을 자동으로 트리거하지 않음. - 계정 전환: 반드시 순서대로
kling logout→kling login→kling who_am_i실행.logout이 성공한 후에만login을 진행할 수 있음; 브라우저 인증 시 사용자가 대상 계정을 선택; 로그인 성공 후who_am_i로 현재 신원을 표시하고 확인. logout실패 시 반드시 즉시 중단: 로컬 로그인 상태를 유지하여 재시도 가능하게 하고, 원래 오류를 사용자에게 알림; 실패를 건너뛰고 바로login하지 마십시오.login실패 시 반드시 즉시 중단: 로그인 오류를 보고하고,who_am_i를 계속 진행하지 않으며, Cookie, 토큰 붙여넣기, 패킷 캡처 등의 다른 인증 방식을 사용하지 마십시오.login을 전환 절차 대신 사용하지 마십시오:login은 로컬 OAuth 인증만 담당하며, 단독 실행 시 서버 측 이전 인증이 취소되었음을 보장하지 않습니다. 사용자가 명시적으로 "계정을 전환"하라고 말하면 반드시 먼저logout을 실행해야 합니다.
개인 및 팀 워크스페이스
who_am_i로 로그인 신원을 확인하고, tool_list로 실시간 도구 및 파라미터를 확인합니다. CLI 0.2.4의 account는 계정 잔액을 조회하며, 워크스페이스 옵션을 거부합니다. 서버가 명시적으로 워크스페이스 선택을 선언하고 과금 귀속을 확인할 수 있는 경우에만 사용자가 지정한 워크스페이스에서 비용을 차감하는 작업을 제출할 수 있습니다.
Element 주체 워크플로우 및 호환성 제약
- 생성: 이미지 Element는
--cover+ 1–3개의--secondary사용; 비디오 Element는--video만 사용, 두 리소스는 혼합 전송 불가. 둘 다 최소 하나의--tag필요, 태그는 현재 지역element_create의 실시간 도구 description에서 선택하여 원본 그대로 전달해야 함; 생성 및 업데이트 시 대화 언어로 태그를 번역하거나 특정 지역의 디렉토리를 하드코딩하지 마십시오. 선택적.mp3--voice. 로컬 파일 자동 업로드. - 바인딩 전 유형 및 호환성 확인: 먼저
element_list로 id를 찾고,element_get <id>로 전체resource를 확인하며, 동시에 실시간 도구 description의 주체 유형 제한 및who_am_i의 모델 파라미터를 확인. 대상 모델은 반드시elements를 선언해야 함; 이미지 주체는 모델 이름이kling-image-o1이라는 이유만으로 거부되어서는 안 됨. 모델이elements를 선언했지만 도구 description이 해당 주체 유형 또는 호출 방식을 명시적으로 금지하는 경우, 여전히 해당 제한을 준수해야 하며, 파라미터 존재만으로 지원을 확인해서는 안 됨; 다른 선언이 충돌하여 호환성을 확인할 수 없는 경우, 사용자에게 구체적인 충돌을 알리고 해당 바인딩 제출을 중단하며, 과금 작업으로 테스트하지 마십시오. 호환되는 모델은 사용자 의도에 부합해야 하며, 모델 전환 전 재시도 및 선택 규칙을 따라야 함. - 바인딩 작성법: 프롬프트에서
<<<id>>>로 주체를 표시하고, 동시에who_am_i선언에 따라--elements '[{"id":"<id>","bindName":"<name>","type":"<element_get이 반환한 유형>"}]'전달. 플레이스홀더만 작성하고elements를 누락하거나, 호환되지 않는 도구/모델에 강제로 전달하지 마십시오. - 업데이트는 변경 필드만 전달: 사용자가 기존 필드를 수동으로 보완할 필요 없으며,
--cover도 전달하지 마십시오. 실제 TTY에서elementId가 누락되면 먼저 입력을 안내합니다.