비디오 생성

공통 필드로 기본 매개변수를 제출하고 metadata로 Kling 전용 매개변수를 전달합니다.

POST/v1/video/generations

공통 JSON 작업 형식으로 Kling 비디오를 생성합니다. 플랫폼은 공통 필드를 Kling 네이티브 매개변수에 매핑하며 공급업체 확장 필드는 metadata에 넣습니다.

모델 ID 예시에는 kling-v1, kling-v2-master, kling-v2-6, kling-video-o1이 있습니다. 실제 사용 가능한 모델은 현재 API 키가 반환하는 모델 목록을 기준으로 합니다.

인증

bearerAuth

인증Bearer <token>

Authorization Header에 Bearer your-api-key를 사용합니다.

전달 위치: header

요청 본문

application/json

Kling 플랫폼 형식 비디오 생성 요청입니다.

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

model*string

Kling 비디오 모델 ID입니다. 예를 들어 kling-v1, kling-v2-master, kling-v2-6, kling-video-o1입니다. 실제 사용 가능한 모델은 현재 API 키가 반환하는 모델 목록을 기준으로 합니다.

길이1 <= length

prompt*string

긍정 프롬프트이며 최대 2500자입니다.

길이length <= 2500

image?string

참조 이미지 URL입니다. 플랫폼은 Kling의 init_image에 매핑하고 이미지 기반 비디오 생성을 활성화합니다.

size?string

비디오 크기입니다. 플랫폼은 너비와 높이를 Kling의 aspect_ratio에 매핑합니다.

duration?number

비디오 길이이며 단위는 초입니다. 플랫폼 형식은 5 또는 10을 지원하고 duration_string에 매핑합니다.

허용 값

metadata?

Kling 공급업체 확장 매개변수입니다. 공통 필드가 아닌 필드는 이 객체에 넣어야 합니다.

응답 본문

`application/json`

curl -X POST "https://example.com/v1/video/generations" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "고양이가 무대에서 노래하고 있습니다. 영화 같은 스타일",
    "size": "1280x720",
    "duration": 5
  }'

{
  "id": "video_123",
  "object": "video",
  "model": "MODEL_ID",
  "created_at": 1640995200,
  "task_id": "abcd1234efgh",
  "status": "processing"
}

인증

요청 본문

응답 본문

201application/json

400application/json

401application/json

403application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`