API 레퍼런스
통합 가이드
요금 및 결제
Omni 비디오
CometAPI Omni Video 엔드포인트(POST /kling/v1/videos/omni-video)를 통해 Kling O1 비디오를 생성하고 Omni Query로 작업 상태를 추적합니다.
curl --request POST \
--url https://api.cometapi.com/kling/v1/videos/omni-video \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "The boy in <<<image_1>>> is wearing <<<element_1>>> and, together with the girl in <<<image_2>>>, sits side by side in <<<element_2>>>, playfully and intimately chatting, close-up shot."
}
'{}입력 모드 선택
- 텍스트-투-비디오:
prompt,mode,aspect_ratio,duration를 전송합니다 - 이미지 참조 생성:
image_list를 추가합니다 - 요소 가이드 생성:
element_list를 추가합니다 - 비디오 변환:
refer_type: base와 함께video_list를 추가합니다
작업 흐름
Omni 작업 폴링
task_status: submitted를 반환했으며, 후속 Omni query는 이후 SUCCESS에 도달하고 최종 MP4 URL을 반환한 것이 확인되었습니다.인증
Bearer token authentication. Use your CometAPI key.
헤더
Content type of the request body.
본문
Text prompt describing the desired video. Max 2500 characters. Reference images or elements inline using <<<image_1>>>, <<<element_1>>>, <<<video_1>>> syntax.
Model to use. Currently only kling-video-o1 is supported.
Reference images for the generation. Each entry can optionally include a type field set to first_frame or end_frame to pin the image as the video's start or end frame. Accepts URLs or Base64 strings. Formats: JPG, JPEG, PNG. Max 10 MB per image, minimum 300 px per side, aspect ratio 1:2.5–2.5:1. When used with reference videos, image + element count must not exceed 4; without reference videos, the limit is 7.
Show child attributes
Show child attributes
Pre-registered element references by ID. Combined with images, the total count must not exceed 4 (with reference video) or 7 (without).
Show child attributes
Show child attributes
Generation mode. std (standard, faster and more cost-effective) or pro (professional, higher quality output).
Output video aspect ratio (width:height). Values: 16:9, 9:16, 1:1. Required when not using a first-frame reference image or video editing.
Video length in seconds. Values: 3–10. Text-to-video and first-frame-to-video only support 5 and 10. When editing an existing video, duration matches the input and this parameter is ignored.
Reference video for style transfer or the base video to edit. Use refer_type to distinguish: feature for style reference, base for the video to modify. Set keep_original_sound to yes or no to control audio retention. Only MP4/MOV, 3–10 seconds, 720–2160 px, 24–60 fps, max 200 MB. Only one video is accepted.
Webhook URL for task status notifications. The server sends a callback when the task status changes.
Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.
응답
Success
The response is of type object.
curl --request POST \
--url https://api.cometapi.com/kling/v1/videos/omni-video \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "The boy in <<<image_1>>> is wearing <<<element_1>>> and, together with the girl in <<<image_2>>>, sits side by side in <<<element_2>>>, playfully and intimately chatting, close-up shot."
}
'{}