Skip to main content
POST
cURL
이 엔드포인트를 사용하면 프롬프트로부터 Kling 텍스트-투-비디오 작업을 생성할 수 있습니다. 완성된 비디오를 즉시 반환하는 대신 비동기 작업을 시작합니다.

첫 번째로 동작하는 요청

  • 먼저 짧은 프롬프트를 보내세요
  • kling-v3 예시부터 시작한 다음, 다른 모델 계열이 필요할 때 OpenAPI enum에서 다른 model_name을 선택하세요
  • 기본 흐름이 정상적으로 동작한 후에만 aspect_ratio, duration, mode, sound를 추가하세요
  • 순수 폴링 대신 푸시 전달을 원하면 callback_url을 설정하세요
  • 생성 사운드를 지원하는 모델에서 오디오 없는 결정적 첫 요청이 필요하다면 sound: off를 사용하세요

모델 이름 지정

이 엔드포인트에서는 일반적인 Kling 비디오 model ID를 사용하세요. Omni model ID는 Omni Video용으로 유지하세요.

duration 및 종횡비

이 엔드포인트는 별도의 해상도 토큰이나 정확한 size 필드를 제공하지 않습니다. 요청한 종횡비가 출력 프레임 형태를 제어합니다.

작업 흐름

1

생성 요청 제출

이 엔드포인트를 통해 작업을 생성하고 반환된 Kling task id를 저장하세요.
2

작업 상태 폴링

작업이 종료 상태에 도달할 때까지 Kling 작업 조회를 통해 진행 상황을 확인하세요.
3

결과 저장

Kling이 완성된 에셋 메타데이터를 반환하면 장기 보관이 필요할 경우 결과를 자체 스토리지로 옮기세요.
전체 파라미터 매트릭스와 모델 계열 세부 정보는 Kling 공식 문서를 참고하세요.

인증

Authorization
string
header
필수

Bearer token authentication. Use your CometAPI key.

헤더

Content-Type
string

Must be application/json.

본문

application/json
prompt
string
필수

Text prompt describing the video to generate. Maximum 500 characters.

negative_prompt
string

Elements to exclude from the video. Maximum 200 characters.

aspect_ratio
enum<string>

Aspect ratio request. Typical rendered sizes are 1280x720 for 16:9, 720x1280 for 9:16, and 960x960 for 1:1. This endpoint does not expose an exact size field.

사용 가능한 옵션:
16:9,
9:16,
1:1
callback_url
string

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

model_name
enum<string>
기본값:kling-v1

Model ID for this text-to-video request. Use an ordinary Kling video model ID; use Omni model IDs only with the Omni Video endpoint.

사용 가능한 옵션:
kling-v1,
kling-v1-6,
kling-v2-master,
kling-v2-1-master,
kling-v2-5-turbo,
kling-v2-6,
kling-v3
cfg_scale
number

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

mode
enum<string>
기본값:std

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

사용 가능한 옵션:
std,
pro
duration
string
기본값:5

Output video length in seconds. Use 5 or 10; omit to use 5.

camera_control
object

Camera motion preset or manual configuration. Omit for automatic camera movement.

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.

sound
enum<string>

Optional generated-audio switch for models that support video sound. Use on or off, or omit the field for the model default.

사용 가능한 옵션:
on,
off

응답

200 - application/json

Successful Response

code
integer

Error code; specifically define the error code

message
string

error message

request_id
string

Request ID, system-generated, for tracking requests, troubleshooting issues

data
object