텍스트로 동영상 생성

Kling 4.0 네이티브 형식으로 텍스트 동영상 작업을 제출합니다.

프롬프트에는 원하는 내용과 피할 내용을 함께 적을 수 있습니다. settings는 길이·해상도·화면 비율, options는 콜백·워터마크 설정입니다.

POST/kling/text-to-video/kling-4.0

프롬프트로 Kling 4.0 영상을 생성합니다. 모델은 경로로 정하므로 본문에 model이 필요하지 않습니다.

인증

bearerAuth

인증Bearer <token>

플랫폼 API Key 사용: Authorization: Bearer your-api-key.

전달 위치: header

요청 본문

application/json

TypeScript 타입 정의

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

prompt*Prompt

긍정·부정 설명을 모두 프롬프트에 쓸 수 있습니다. 영어만 사용 시 최대 26000자, 비영어만은 11000자. 혼합 시 E/26000 + N/11000 <= 1을 충족해야 합니다. E는 영어, N은 비영어 문자 수입니다.

settings?

options?

응답 본문

`application/json`

curl -X POST "https://api.agtcloud.cn/kling/text-to-video/kling-4.0" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "밝은 해안, 파도가 모래사장을 가볍게 두드리고 카메라가 천천히 전진한다.",
    "settings": {
      "duration": 3,
      "resolution": "720p"
    }
  }'

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "REQUEST_ID",
  "data": {
    "id": "123456789012345678",
    "status": "submitted",
    "message": "",
    "create_time": 1792713600000,
    "update_time": 1792713600000
  }
}

주요 오류와 해결 방법

응답·오류	확인 및 조치
HTTP 401, `Invalid token`	Bearer 형식과 API Key의 요청 사이트 확인
HTTP 400, `prompt cannot be empty`	비어 있지 않은 텍스트 프롬프트 제공
HTTP 400, `prompt value type is invalid`	`prompt`는 배열·객체가 아닌 문자열
HTTP 400, `invalid_request`	`settings.duration` 등의 유형 확인. 길이는 정수
HTTP 400, 해상도·비율 검증 오류	`settings.resolution`와 `settings.aspect_ratio`에 이 페이지의 열거 값 사용
HTTP 400, `invalid JSON request body`	JSON 구문 확인, 요청 본문에서 주석 제거

공통 검증 오류는 모델의 지원 범위보다 넓은 값을 표시할 수 있습니다. 이 API는 정수 3～30초, 720p 또는 1080p를 사용합니다. 오류 문구만 보고 다른 길이·해상도를 지원한다고 판단하지 마세요.

생성 오류는 성공 응답과 다른 code/message/data 또는 error 객체일 수 있습니다. fail_to_fetch_task의 원인은 message에 있으며 code/message/request_id를 포함한 JSON 문자열일 수 있습니다. 요청 ID를 보관하고 API Key는 제공하지 마세요.

인증

요청 본문

응답 본문

200application/json

400application/json

401application/json

주요 오류와 해결 방법

`application/json`

`application/json`

`application/json`