이미지로 동영상 생성

첫 프레임, 첫·마지막 프레임 또는 여러 키프레임으로 Kling 4.0 동영상을 생성합니다.

contents에 프롬프트와 키프레임을 조합합니다. 작업당 이미지는 최대 10장입니다. 이 API에는 aspect_ratio가 없으므로 원하는 비율의 참조 이미지를 사용하세요.

POST/kling/image-to-video/kling-4.0

첫 프레임·첫/마지막·다중 키프레임으로 생성하며 작업당 최대 10장입니다. 화면 비율은 참조 이미지를 따르며 aspect_ratio는 제공하지 않습니다.

인증

bearerAuth

인증Bearer <token>

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

전달 위치: header

요청 본문

application/json

TypeScript 타입 정의

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

contents*array<|>

이미지 하나 이상 필수, 프롬프트 선택. 최대 10장. 첫·중간·마지막을 모두 동시에 제공할 필요는 없음.

항목1 <= items

settings?

options?

응답 본문

`application/json`

curl -X POST "https://api.agtcloud.cn/kling/image-to-video/kling-4.0" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "type": "prompt",
        "text": "카메라를 고정하고 @first의 파도를 천천히 움직인다."
      },
      {
        "type": "first_frame",
        "id": "first",
        "url": "https://example.com/first.jpg"
      }
    ],
    "settings": {
      "duration": 5,
      "resolution": "720p"
    }
  }'

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

이미지와 참조 규칙

contents는 first_frame(첫 프레임), middle_frame(중간), last_frame(마지막)을 지원합니다. 프롬프트 항목 type: "prompt"는 선택 사항입니다. 첫 프레임·첫/마지막·다중 키프레임 요청 예제를 제공합니다.

항목	요구 사항
이미지 소스	`url` 필수, URL 또는 Base64
형식·크기	JPG, JPEG, PNG, 이미지당 최대 30MB
크기	너비·높이 모두 300px 이상, 비율 2:5～5:2
이미지 수	작업당 최대 10장
소재 참조 ID	`id` 선택, 같은 작업 내 중복 불가

프롬프트에서 이미지를 지정하려면 id를 설정합니다. 예를 들어 "id": "first"는 @first에 대응합니다. id는 이 요청 안의 참조이며 생성 후 반환되는 작업 ID가 아닙니다.

주요 오류와 해결 방법

응답·오류	확인 및 조치
HTTP 401, `Invalid token`	Bearer 형식과 API Key의 요청 사이트 확인
HTTP 400, `contents cannot be empty`	비어 있지 않은 `contents` 배열 제공
HTTP 400, `contents must contain at least one of first_frame, middle_frame, last_frame`	키프레임 이미지 하나 이상 제공. 프롬프트만으로는 불가
HTTP 400, `must have a non-blank url`	해당 키프레임에 비어 있지 않은 `url` 제공
HTTP 400, `contents[0].type ... is invalid`	지정 인덱스의 소재 유형을 확인하고 지원되는 키프레임·프롬프트 유형 사용
HTTP 400, `invalid_request` 또는 `invalid JSON request body`	JSON 구문과 유형 확인. `contents`는 문자열이 아닌 배열

HTTP 400은 code/message/data 또는 error 객체일 수 있습니다. fail_to_fetch_task가 반드시 조회 오류를 뜻하지는 않습니다. message의 소재 검증 원인을 확인하세요. 해당 값은 객체가 아닌 JSON 문자열일 수 있습니다. 요청 ID를 보관하고 API Key는 제공하지 마세요.

인증

요청 본문

응답 본문

200application/json

400application/json

401application/json

이미지와 참조 규칙

주요 오류와 해결 방법

`application/json`

`application/json`

`application/json`