Kling Omni 비디오 만들기

POST

kling

videos

omni-video

curl https://api.cometapi.com/kling/v1/videos/omni-video \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "model_name": "kling-v3-omni",
      "prompt": "A paper boat drifts across a calm pond at sunrise.",
      "mode": "std",
      "aspect_ratio": "16:9",
      "duration": "5",
      "sound": "off"
    }'

{
  "code": 0,
  "message": "SUCCEED",
  "data": {
    "task_id": "<task_id>",
    "task_status": "submitted",
    "task_info": {
      "external_task_id": null
    },
    "task_status_msg": null,
    "created_at": 1773366840306,
    "updated_at": 1773366840306
  }
}

CometAPI에서 제공하는 O1 호환 Kling Omni 워크플로에 이 엔드포인트를 사용하세요. 여기에는 텍스트-투-비디오와 첫 프레임 이미지 참조 생성이 포함됩니다.

전체 provider 파라미터 참조는 Kling Omni Video 문서를 확인하세요.

입력 모드 선택

텍스트-투-비디오: prompt, mode, aspect_ratio, duration을 전송합니다
첫 프레임 이미지 참조: image_url과 type: first_frame가 포함된 image_list 항목을 추가한 다음, prompt에서 이미지를 <<<image_1>>>로 참조합니다
워터마크 출력: 조회 응답에서 워터마크가 포함된 비디오 URL이 필요하면 watermark_info.enabled: true를 추가합니다
Model ID: 기본 라우트 값을 사용하려면 model_name을 생략하거나, kling-video-o1 또는 kling-v3-omni 같은 테스트된 Omni Video model ID를 전송합니다

길이와 화면 비율

설정	지원 값	기본값	경계 동작
텍스트 또는 첫 프레임 비디오용 `duration`	`"5"`, `"10"`	`"5"`	값을 문자열로 전송하고, 두 가지 고정 생성 길이 중 하나를 사용합니다.
`aspect_ratio`	`16:9`, `9:16`, `1:1`	`16:9`	첫 프레임 이미지가 프레임을 제어하지 않는 경우 필수입니다.
`mode`	`std`, `pro`	라우트 기본값	표준 생성에는 `std`를 보내고, 선택한 모델이 더 높은 품질 모드를 지원하는 경우에만 `pro`를 보냅니다.

Kling Omni는 정확한 size 필드를 제공하지 않습니다. aspect_ratio를 프레임 형태 요청으로 취급하세요. 16:9 텍스트-투-비디오 요청은 full-HD 1920x1080으로 렌더링될 수 있습니다.

작업 흐름

Omni 작업 만들기

요청을 제출하고 반환된 task_id를 저장합니다.

Omni 작업 폴링

작업이 완료될 때까지 Kling Omni 비디오 가져오기를 계속 진행합니다.

완성된 비디오 저장

지속적으로 접근해야 한다면 반환된 MP4 URL을 자체 스토리지로 옮기세요.

인증

Authorization

string

header

필수

Bearer token authentication. Use your CometAPI key.

헤더

Content-Type

string

Content type of the request body.

본문

application/json

prompt

string

필수

Text prompt describing the desired video. Maximum length is 2,500 characters. When you send image_list, reference the image with <<<image_1>>>.

model_name

string

Optional model ID for this Kling Omni video request. Omit this field to use the route default.

image_list

object[]

Optional first-frame image reference for image-referenced Omni generation.

Show child attributes

sound

enum<string>

기본값:off

Whether to generate audio with the video. Use on or off.

사용 가능한 옵션:

on,

off

mode

enum<string>

Generation mode. Use std for standard generation or pro when the selected model supports the higher-quality mode.

사용 가능한 옵션:

std,

pro

aspect_ratio

enum<string>

Aspect ratio request for beta Kling Omni generation. The endpoint does not expose an exact size field; a 16:9 text-to-video request can render as 1920x1080.

사용 가능한 옵션:

16:9,

9:16,

1:1

duration

enum<string>

기본값:5

Requested output length for text-to-video and first-frame image-reference workflows. Use 5 or 10 as a string.

사용 가능한 옵션:

5,

10

watermark_info

object

Watermark options. When enabled is true, the task can return watermarked result URLs in addition to original result URLs.

Show child attributes

callback_url

string<uri>

Webhook URL for task status notifications. The server sends a callback when the task status changes.

external_task_id

string

Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

응답

200 - application/json

Success

code

integer

필수

Response code. 0 means the task request was accepted.

message

string

필수

Response message.

data

object

필수

Show child attributes

request_id

string

Request identifier returned by CometAPI when present.

Kling 작업 가져오기

Kling Omni 비디오 가져오기

curl https://api.cometapi.com/kling/v1/videos/omni-video \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "model_name": "kling-v3-omni",
      "prompt": "A paper boat drifts across a calm pond at sunrise.",
      "mode": "std",
      "aspect_ratio": "16:9",
      "duration": "5",
      "sound": "off"
    }'

{
  "code": 0,
  "message": "SUCCEED",
  "data": {
    "task_id": "<task_id>",
    "task_status": "submitted",
    "task_info": {
      "external_task_id": null
    },
    "task_status_msg": null,
    "created_at": 1773366840306,
    "updated_at": 1773366840306
  }
}

콘텐츠 검토

API 키

입력 모드 선택

길이와 화면 비율

작업 흐름

인증

헤더

본문

응답

​입력 모드 선택

​길이와 화면 비율

​작업 흐름

인증

헤더

본문

응답

입력 모드 선택

길이와 화면 비율

작업 흐름