API 레퍼런스
통합 가이드
요금 및 결제
이미지를 비디오로
CometAPI POST /kling/v1/videos/image2video를 통해 단일 이미지를 Kling 비디오로 변환하며, 비동기 작업 생성과 task ID 기반 진행 상태 추적을 지원합니다.
{
"code": 0,
"message": "success",
"data": {
"task_id": "2032273942220931072",
"task_status": "submitted",
"task_info": {},
"created_at": 1773366840306,
"updated_at": 1773366840306
}
}호출 전 확인 사항
- 공개적으로 접근 가능한 이미지 URL 하나 또는 base64 이미지 문자열 하나를 제공하세요
- 최소한의 최신 요청을 위해
model_name: kling-v2-master로 시작하세요 - 첫 요청은 단순하게 유지하세요: 입력 이미지 1개, 프롬프트 1개, tail frame 없음, motion mask 없음
작업 흐름
작업 폴링
kling-v2-master 요청이 정상적으로 수락되었고 task_status: submitted가 반환되는 것이 확인되었습니다.인증
Bearer token authentication. Use your CometAPI key.
본문
Source image as a Base64 string or public URL. Accepted formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300×300 px.
Text prompt describing the desired motion. Maximum 500 characters.
Elements to exclude from the video. Maximum 200 characters.
Webhook URL to receive task status updates when the task completes.
Generation mode. std for standard (faster), pro for professional (higher quality).
Kling model variant to use. See the Models page for current options.
Tail-frame reference image as a Base64 string or public URL. Same format requirements as image. Controls the last frame of the generated video.
Prompt adherence strength. Higher values follow the prompt more closely. Range: 0–1.
Output video length in seconds. Options: 5, 10.
Static brush mask image as a Base64 string or public URL. White areas are frozen in place during video generation. Must match the aspect ratio and resolution of the input image.
Dynamic brush configuration. Up to 6 groups, each containing a painted-area mask and a motion trajectory.
Show child attributes
Show child attributes
Custom task id for your own tracking. Does not replace the system-generated task id but can be used to query tasks. Must be unique per user.
{
"code": 0,
"message": "success",
"data": {
"task_id": "2032273942220931072",
"task_status": "submitted",
"task_info": {},
"created_at": 1773366840306,
"updated_at": 1773366840306
}
}