이미지에서 비디오로 - CometAPI Documentation

{ "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 task_id를 저장하세요.

작업 폴링

출력이 준비될 때까지 개별 조회를 통해 작업 상태를 계속 확인하세요.

결과 저장

제공업체의 전달 URL 이후에도 보관이 필요하다면 완료된 에셋을 저장하세요.

전체 파라미터 참조는 Kling 공식 문서를 확인하세요.

인증

Authorization

string

header

필수

Bearer token authentication. Use your CometAPI key.

본문

application/json

image

string

기본값:example

필수

Source image as a Base64 string or public URL. Accepted formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300×300 px.

prompt

string

Text prompt describing the desired motion. Maximum 500 characters.

negative_prompt

string

Elements to exclude from the video. Maximum 200 characters.

callback_url

string

Webhook URL to receive task status updates when the task completes.

mode

string

Generation mode. std for standard (faster), pro for professional (higher quality).

model_name

string

Kling model variant to use. See the Models page for current options.

image_tail

string

Tail-frame reference image as a Base64 string or public URL. Same format requirements as image. Controls the last frame of the generated video.

cfg_scale

number

Prompt adherence strength. Higher values follow the prompt more closely. Range: 0–1.

duration

string

Output video length in seconds. Options: 5, 10.

static_mask

string

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_masks

object

Dynamic brush configuration. Up to 6 groups, each containing a painted-area mask and a motion trajectory.

Show child attributes

external_task_id

string

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.

응답

200 - application/json

Task accepted.

code

integer

필수

Error code; specifically define the error code

message

string

필수

error message

data

object

필수

Show child attributes

{ "code": 0, "message": "success", "data": { "task_id": "2032273942220931072", "task_status": "submitted", "task_info": {}, "created_at": 1773366840306, "updated_at": 1773366840306 } }

Documentation Index

​호출 전에 확인할 사항

​작업 흐름

인증

본문

응답

호출 전에 확인할 사항

작업 흐름