Kuaishou

Kling 2.5

kling-2.5-turbo/image-to-video

콰이쇼우가 출시한 이미지-투-비디오 모델로, 동작의 유려함과 캐릭터 일관성이 뛰어나며 네거티브 프롬프트와 CFG 조절을 지원해 역동적인 숏폼 영상 생성에 적합합니다

kling-2.5-turbo/image-to-video kling-2.5-turbo/text-to-video

kling-2.5-turbo/image-to-video 사용해 보기

입력

작품 갤러리

모든 작품 보기

출력

video

파라미터를 입력하고 생성하면 결과가 여기에 표시됩니다.

가격

kling-2.5-turbo/image-to-video per second

단가	$0.060

포지셔닝 소개

kling-2.5-turbo/image-to-video는 이미지-투-비디오 작업을 위한 모델로, 한 장 또는 두 장의 이미지를 첫 프레임과 선택적 마지막 프레임으로 사용하고 텍스트 프롬프트와 결합하여 5초 또는 10초의 짧은 영상을 생성합니다. 네거티브 프롬프트와 0–1 범위의 프롬프트 준수 강도 조절을 지원하며, 화면 비율은 단일 이미지 또는 이중 이미지 모드에서 선택할 수 있습니다. 정적 화면을 동적 클립으로 변환하고 파라미터로 화면 내용을 제어하려는 개발자에게 적합합니다.

핵심 하이라이트

첫·마지막 프레임 이중 이미지 구동——첫 프레임 한 장 또는 여기에 마지막 프레임 한 장을 추가로 전달하여, 영상이 지정된 화면에서 시작해 지정된 종료 화면으로 전환되도록 합니다.
프롬프트 준수 강도 조절 가능——cfg_scale을 0–1 사이에서 조절하여 영상이 텍스트 설명을 따르는 정도를 제어할 수 있어, 자유로운 표현과 엄격한 재현 사이에서 선택하기 쉽습니다.
네거티브 프롬프트로 간섭 배제——최대 2496자의 네거티브 프롬프트를 지원하여 화면에 나타나지 않기를 원하는 내용을 억제합니다.

기능 설명

첫 프레임 및 선택적 마지막 프레임 입력: image_urls는 1~2개의 이미지 URL을 받으며 jpeg/png/webp를 지원하고 각 이미지 최대 10MB입니다. 두 장의 이미지를 전달하면 첫 프레임에서 마지막 프레임까지의 전환을 생성합니다.

길이 및 화면 비율 선택: duration은 5초 또는 10초를 선택할 수 있으며, 단일 이미지 모드의 화면 비율은 16:9, 9:16, 1:1, 4:3, 3:4, 21:9를 지원하고 이중 이미지 모드는 16:9, 9:16, 1:1로 제한됩니다.

프롬프트 및 네거티브 프롬프트: prompt는 필수이며 최대 2500자로, 주요 대상의 동작, 환경 변화, 카메라 움직임을 설명하는 데 사용합니다. negative_prompt는 최대 2496자로, 원하지 않는 내용을 배제하는 데 사용합니다.

준수도 조절: cfg_scale은 0–1의 값을 가지며, 값이 높을수록 영상이 텍스트 설명을 더 강하게 따르므로 촬영 요구에 따라 생성 결과의 밀착 정도를 조정할 수 있습니다.

적용 시나리오

광고 및 제품 단편 영상 제작자: 단일 제품 이미지 + 동작 설명——정적 제품 이미지를 카메라 움직임이 있는 짧은 클립으로 변환하여 브랜드 또는 이커머스 영상의 동적 전시 소재로 활용합니다.
영상 사전 프리뷰: 콘셉트 이미지 + 첫·마지막 프레임 지정——두 장의 콘셉트 이미지로 시작과 끝 화면을 고정하고 전환 클립을 생성하여 스토리보드나 콘셉트 영상 프리뷰로 사용합니다.
소셜 미디어 콘텐츠 운영: 세로형 이미지 + 짧은 프롬프트——9:16 화면 비율로 이미지를 5초 또는 10초 세로형 숏폼 영상으로 변환하여 소셜 플랫폼 게시에 바로 사용합니다.

제한 사항 및 선택 가이드

1회 생성 길이 상한은 10초로, 장편 영상을 직접 제작하기에는 적합하지 않습니다. 이중 이미지 모드의 화면 비율은 16:9, 9:16, 1:1만 지원하며, 단일 이미지 모드는 대체 처리 시 원본 이미지 비율을 따를 수 있어 요청한 크기를 정확히 보장하지 못합니다. WebP 이미지는 자동 변환되지 않으며 일부 대체 처리는 jpeg/png만 허용합니다. 생성 품질은 프롬프트 작성과 cfg_scale 튜닝에 크게 의존합니다. 텍스트로부터 영상을 직접 생성해야 하는 경우 동일 계열의 텍스트-투-비디오 모델을 선택해야 합니다.

새소식

변경 이력 보기 →

새 모델 kling-2.5-turbo/text-to-video 문서 추가 Oct 10, 2026
새 모델 비디오 모델 문서 추가: kling-2.5-turbo/image-to-video (첫 프레임 기반, 고정 5초 1080p, 선택 가능… Oct 8, 2026

생성 작업 제출

POST https://api.hiapi.ai/v1/tasks

헤더

Authorizationstring필수

계정 API 키. 모든 요청에 필수입니다. 예: Bearer YOUR_HIAPI_API_KEY. API 키 받기

Content-Typestring선택

요청 본문은 항상 JSON으로 파싱됩니다. 전송 시 application/json(charset 포함 가능)만 허용되며, 다른 값은 415를 반환합니다. 예: application/json.

Idempotency-Keystring선택

멱등 키. 최대 255바이트. 같은 계정에서 같은 키의 재시도는 태스크를 한 번만 생성하며, 재전송 시 최초의 taskId를 반환합니다.

멱등 키

네트워크 타임아웃이나 클라이언트 자동 재시도 시 같은 키로는 태스크를 한 번만 생성하고 이중 과금되지 않습니다(범위 = API 키의 계정). 업무 고유 식별자(예: "order-42")를 키로 사용할 것을 권장합니다. 같은 키 재전송 시 최초 taskId를 반환하며, 키는 첫 제출 후 24시간 뒤 만료됩니다. 자세한 시나리오 표는 통합 비동기 API 소개 페이지를 참고하세요.

본문

modelstring필수

현재 고정 값: kling-2.5-turbo/image-to-video

routestring선택

현재 고정 값: default

inputobject필수

kling-2.5-turbo/image-to-video 및 루트 default의 비즈니스 파라미터 객체. 아래 파라미터 표를 참조하세요.

promptstring필수minLength 1maxLength 2500

주체의 동작, 환경 변화 및 카메라 움직임을 설명하는 텍스트 프롬프트로, 생성될 비디오의 내용 방향을 결정합니다.

durationinteger선택기본값: 5min 5max 10

생성할 비디오의 초 수를 선택하며, 정수를 입력하고 기본값은 5입니다.

옵션:510

cfg_scalenumber선택min 0max 1

비디오가 텍스트 설명을 따르는 정도를 조정하며, 숫자 값을 입력하고 값이 높을수록 프롬프트에 더 강하게 부합합니다.

image_urlsarray필수minItems 1maxItems 2

첫 프레임과 선택적 마지막 프레임의 이미지 URL 배열로, jpeg/png/webp를 지원하며 각 이미지 최대 10MB입니다. 일부 대체 처리에서는 jpeg/png만 허용되며 WebP는 자동 변환되지 않고, 두 장의 이미지를 사용할 때는 16:9, 9:16 또는 1:1만 지원됩니다.

Array [ string ]

aspect_ratiostring선택기본값: "16:9"

비디오 화면 비율로, 기본값은 16:9입니다. 단일 이미지는 대체 처리 시 원본 이미지 비율을 따를 수 있어 요청한 크기와 정확히 일치한다고 보장할 수 없습니다. image_urls를 제공할 때는 16:9, 9:16 또는 1:1만 지원됩니다.

옵션:16:99:161:14:33:421:9

negative_promptstring선택maxLength 2496

비디오에 나타나지 않기를 원하는 내용으로, 문자열 값을 입력하며 최대 2496자입니다.

callbackobject선택

종료 상태 알림 설정. 생략하면 콜백이 전송되지 않으며 호출 측에서 폴링합니다.

콜백(Webhook)

생성 시 callback.url을 지정하면 태스크 종료 시 HiAPI가 서비스로 POST하여 폴링이 필요 없습니다. 콜백 본문은 태스크 상세와 동일한 구조입니다. 서명 검증·재시도·멱등에 대한 자세한 내용은 통합 비동기 API 소개 페이지의 콜백 설명을 참고하세요.

urlstring필수

callback 사용 시 필수. 태스크 종료 후 이 URL로 POST됩니다. 유효한 http(s) URL이어야 합니다.

whenstring선택기본값: "final"

현재는 final만 지원(success / fail 모두 알림).

옵션:final

storagestring선택기본값: "temp"

산출물 저장 등급: temp(기본·약 7일) 또는 persistent(장기 보관·용량 과금). 잔액 부족이나 저장 한도 초과 시 자동으로 temp로 강등됩니다. 실제 적용된 등급은 태스크 상세 응답에서 확인할 수 있습니다.

옵션:temppersistent

요청 예시

# 비동기 태스크 제출. 성공 시 즉시 taskId 반환(생성 완료 대기 없음)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-2.5-turbo/image-to-video",
  "input": {
    "prompt": "…",
    "duration": 5,
    "image_urls": "…",
    "aspect_ratio": "16:9"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "kling-2.5-turbo/image-to-video",
    input: {
      "prompt": "…",
      "duration": 5,
      "image_urls": "…",
      "aspect_ratio": "16:9"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "kling-2.5-turbo/image-to-video",
        "input": {
          "prompt": "…",
          "duration": 5,
          "image_urls": "…",
          "aspect_ratio": "16:9"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

작업 상세 조회

GET https://api.hiapi.ai/v1/tasks/:id

응답 필드

taskIdstring필수

태스크 ID. 접두사는 항상 tk-hiapi-.

modelstring필수

확인된 전체 모델명. route 파라미터로 제출한 태스크는 base@route(예: gpt-image-2/text-to-image@ext)를 반환하며, 그 외에는 제출 시의 모델명과 동일합니다.

routestring선택

route 파라미터를 명시해 제출한 태스크에만 나타나며, 제출한 값을 그대로 반환합니다.

statusstring필수

태스크 상태.

상태 값

queued 대기 중, 아직 시작되지 않음. handling 처리 중. archiving 처리 완료, 산출물 준비 중. success 종료: 완료. 산출물 사용 가능(output 반환). fail 종료: 실패(error 반환). 제출 후 status로 판단합니다: success와 fail이 종료 상태이며 나머지는 비종료입니다. 1~3초 간격으로 종료까지 폴링하세요. 성공 시 output[].url에서 산출물을 다운로드하고 expireAt 전에 옮기세요. 장기 보관이 필요하면 생성 시 storage: "persistent"를 사용하세요.

creatednumber필수

태스크 생성 시각(Unix 초).

completednumber필수

종료 상태가 된 Unix 초. 비종료 상태에서는 0.

outputarray선택

status == success일 때만 나타납니다. 산출물 목록 — 항상 배열이며, 하나의 태스크에서 여러 type을 동시에 반환할 수 있습니다(예: video + first_frame).

Array [ object ]

배열 항목

urlstring필수

산출물 URL. 바로 다운로드할 수 있습니다.

typestring필수

현재 가능한 값: video, image, audio, first_frame, last_frame, thumbnail. 이후 확장될 수 있습니다.

expireAtnumber필수

산출물 접근 가능 기한(Unix 초). 만료 전에 다운로드하거나 이전하세요.

errorobject선택

status == fail일 때만 나타납니다.

codestring필수

비즈니스 오류 코드.

messagestring필수

오류 설명.

응답 예시

성공

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

처리 중(비종료)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

실패

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}