Kling 이미지-투-비디오 작업 생성
CometAPI POST /kling/v1/videos/image2video를 통해 단일 이미지를 Kling 비디오로 변환하며, 비동기 작업 생성과 task ID 기반 진행 상황 추적을 지원합니다.
호출 전에 확인할 사항
- 공개 이미지 URL 1개 또는 base64 이미지 문자열 1개를 제공하세요
- Kling 픽셀 요구사항을 충족하는 이미지를 사용하세요. 너무 작은 썸네일은 생성 작업에서 거부됩니다
- 기본
kling-v2-6예제로 시작한 다음, 다른 모델 계열이 필요할 때 OpenAPI enum에서 다른model_name을 선택하세요 - 첫 번째 요청은 단순하게 유지하세요: 입력 이미지 1개, 프롬프트(Prompt) 1개, tail frame 없음, motion mask 없음
- 제어된 국소 움직임이 필요할 때는
dynamic_masks를 mask-and-trajectory 객체의 배열로 사용하세요 - 생성된 사운드를 지원하는 모델 계열에서는 오디오 없이 결정적인 첫 요청을 위해
sound: off를 사용하세요
모델 이름 지정
이 엔드포인트에서는 일반 Kling 비디오 model ID를 사용하세요. Omni model ID는 Omni Video용으로 유지하세요.작업 흐름
이미지-투-비디오 요청 제출
task_id를 저장하세요.작업 폴링
결과 저장
인증
Bearer token authentication. Use your CometAPI key.
본문
Source image URL or base64 image string. Use an image that meets Kling pixel requirements; very small thumbnails are rejected. For base64 input, send the encoded image string as the field value.
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).
std, pro Model ID for this image-to-video request. Use kling-v3 for new requests. Use Omni model IDs only with the Omni Video endpoint.
kling-v1, kling-v1-5, kling-v1-6, kling-v2-master, kling-v2-1, kling-v2-1-master, kling-v2-5-turbo, kling-v2-6, kling-v3 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. Use 5 or 10; omit to use 5.
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.
Optional motion masks. Each entry contains a mask image and an ordered trajectory list.
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.
Optional generated-audio switch for models that support video sound. Use on or off, or omit the field for the model default.
on, off