메인 콘텐츠로 건너뛰기
POST
cURL
POST /omni-video/{model}을 사용하여 비동기 Kling Omni 동영상 작업을 만듭니다. URL에 모델 ID를 지정하고 contents에 입력을 제공합니다.

모델 선택

  • kling-3.0-omni: 720p, 1080p, 또는 4k; 3~15초; native, original 또는 off 오디오.
  • kling-o1: 720p 또는 1080p; 3~10초; original 또는 off 오디오.
텍스트 전용 예제에서는 kling-3.0-omni을 사용합니다. 무음 동영상을 만들려면 settings.audio을 off로 설정합니다.

요청 매개변수

kling-3.0-omni의 경우 feature_video 입력에는 settings.multi_shot: true 및 settings.audio: off가 필요합니다. base_video 입력에는 settings.multi_shot: false가 필요하며 settings.audio: native을 사용할 수 없습니다. base_video을 첫 번째 또는 마지막 프레임과 함께 사용하지 마세요. kling-3.0-omni의 공식 기본값은 multi_shot: true입니다. 정의된 샷 모드가 필요한 경우 필드를 명시적으로 설정하세요. kling-o1의 경우 프롬프트(Prompt)는 최대 2500자를 포함할 수 있습니다. 요청에 first_frame만 있고 다른 참조 이미지 또는 동영상이 없으면 5초 또는 10초 길이를 사용하세요. 5초 길이의 텍스트 전용 동영상을 만들려면 POST /omni-video/kling-3.0-omni에 이 요청 본문을 보내세요:
응답은 비동기 작업의 id을 반환합니다:
data.id 값을 Kling 작업 가져오기 와 함께 사용하여 작업이 완료될 때까지 기다리세요. 완료된 동영상 URL은 작업의 outputs 배열에서 읽으세요. 지속적인 액세스가 필요하면 자체 스토리지에 동영상을 저장하세요. OpenAPI 패널에는 상응하는 Shell, Python 및 JavaScript 요청이 포함되어 있습니다. 더 많은 입력 조합은 다음을 참조하세요: Kling 3.0 Omni 동영상 API 참조 또는 Kling O1 Omni 동영상 API 참조.

인증

Authorization
string
header
필수

Authenticate with your CometAPI API key.

경로 매개변수

model
enum<string>
필수

Kling Omni model ID. The selected model controls resolution, duration, and audio choices.

사용 가능한 옵션:
kling-3.0-omni,
kling-o1

본문

application/json

Omni video request fields exposed by the CometAPI route. The model ID is a path parameter, not a body field.

contents
object[]
필수

Video input items. Send a prompt item for text-only generation.

Minimum array length: 1
settings
object

Output settings exposed by the CometAPI route. Set model-specific fields explicitly for the intended result.

options
object

Optional task fields exposed by the CometAPI route.

응답

200 - application/json

Task created. Store data.id for a GET /tasks query.

code
필수

Result code. 0 indicates task creation.

message
string
필수

Result message.

data
object
필수

Task identification and submission status.

msg
string

Additional result message, when included.

마지막 수정일 2026년 9월 25일