Kling Image 4.0 이미지 생성
Kling Image 4.0으로 2K, 4K, 8K 이미지 생성 및 편집
중국 본토 사용자 안내: 중국 본토 사용자는 https://toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://toapis.com 을 https://toapis.cn 로 바꿔 주세요.
kling-image-4.0으로 텍스트에서 이미지를 생성하거나, 최대 10개의 참조 이미지를 사용해 편집 및 합성할 수 있습니다. 요청마다 2K, 4K, 8K 중 하나의 해상도로 이미지 한 장을 비동기로 생성합니다.
Authorizations
Authorizationstring헤더필수All endpoints require Bearer Token authentication
Get your API Key from the API Key Management Page
Add to request header:
Authorization: Bearer YOUR_API_KEYBody
application/json으로 요청을 보내고 아래 필드는 요청 본문의 최상위에 지정합니다.
modelstring본문필수기본값: kling-image-4.0kling-image-4.0을 지정합니다.
promptstring본문필수생성할 이미지의 모습이나 참조 이미지에서 바꾸려는 내용을 설명합니다. 공백 외의 문자를 포함해야 합니다.
resolutionstring본문기본값: 2K출력 해상도입니다. 2K, 4K, 8K를 지원하며 대소문자를 구분하지 않습니다.
aspect_ratiostring본문기본값: auto출력 이미지의 가로세로 비율입니다. auto를 지정하면 모델이 비율을 선택합니다. 다음과 같은 고정 비율을 지원합니다.
16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9.
sizestring본문aspect_ratio와 같은 값을 받는 별칭입니다. 두 필드를 모두 지정할 경우 값이 같아야 합니다.
ninteger본문기본값: 1생성할 이미지 수입니다. 1로 고정됩니다. 이 필드를 생략하거나 정수 1을 지정하세요.
image_urlsstring[]본문참조 이미지는 최대 10장입니다. 프롬프트에서 배열 순서대로 @image_1, @image_2 등을 사용해 각 이미지의 역할을 지정할 수 있습니다. 서비스에서 접근할 수 있는 HTTP 또는 HTTPS 이미지 URL을 사용하세요. 로컬 파일은 이미지 업로드 API에서 URL을 받을 수 있습니다.
JPG, JPEG, PNG 형식을 지원합니다. 파일당 최대 30 MB이며, 너비와 높이가 모두 300픽셀 이상이고 가로세로 비율이 2:5에서 5:2 사이여야 합니다.
reference_imagesstring[]본문image_urls의 별칭입니다. 두 필드 중 하나를 사용하세요.
callback_urlstring본문작업이 끝났을 때 알림을 받을 URL입니다. 토큰 작업 웹훅을 설정한 경우 기본 URL과 같은 스킴, 호스트, 포트를 사용해야 합니다. 생략하면 토큰에서 활성화된 기본 URL을 사용합니다.
파라미터 제한
이 엔드포인트는 일반 이미지 한 장을 생성합니다. Kling의 자체 필드인 contents, options, settings, result_type, series_amount는 생략하세요.
작업 조회
응답의 id와 요청에 사용한 API 키로 이미지 작업을 조회하세요. queued와 in_progress는 작업이 진행 중임을 뜻합니다. completed일 때는 result.data[0].url에서 이미지 URL을 가져오고, failed일 때는 error를 확인하세요.
curl "https://toapis.com/v1/images/generations/TASK_ID" \
-H "Authorization: Bearer $TOAPIS_API_KEY"과금
요청 단위로 과금하며, 요금은 계정의 가격 적용 지역과 해상도 등급에 따라 달라집니다. 가로세로 비율과 참조 이미지 수는 요금에 영향을 주지 않습니다. 실제 비용과 작업 사용량을 참고하세요.
Response
idstringUnique task identifier for status queries
objectstringObject type, always generation.task
modelstring모델 name used
statusstring요청이 접수되면 queued입니다.
progressintegerTask progress percentage (0-100)
created_atintegerTask creation timestamp (Unix timestamp)
metadataobjectTask metadata
result.data[].urlstring작업 완료 후 반환되는 이미지 한 장의 URL입니다.
실행 전에 TOAPIS_API_KEY 환경 변수를 설정하세요. 예제의 example.com 참조 주소는 자리표시자이므로 접근 가능한 이미지 URL 로 바꾸세요.
요청 예시
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header "Authorization: Bearer $TOAPIS_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "kling-image-4.0",
"prompt": "바위 해안에 서 있는 빨간색과 흰색 등대. 바다 안개가 걷히고 아침 햇살이 물보라를 비춘다.",
"resolution": "2K",
"aspect_ratio": "16:9"
}'curl --request POST \
--url https://toapis.com/v1/images/generations \
--header "Authorization: Bearer $TOAPIS_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "kling-image-4.0",
"prompt": "@image_1의 책상 조명을 @image_2의 서재에 배치해 주세요. 조명의 형태와 재질을 유지하고 방의 빛과 그림자에 어울리게 해 주세요.",
"resolution": "4K",
"aspect_ratio": "4:3",
"image_urls": [
"https://example.com/lamp.png",
"https://example.com/study.jpg"
]
}'응답 예시
{
"id": "tsk_img_example",
"object": "generation.task",
"model": "kling-image-4.0",
"status": "queued",
"progress": 0,
"created_at": 1794960000,
"metadata": {}
}{
"id": "tsk_img_example",
"object": "generation.task",
"model": "kling-image-4.0",
"status": "completed",
"progress": 100,
"created_at": 1794960000,
"result": {
"type": "image",
"data": [
{
"url": "https://example.com/generated/kling-image-4.0.png"
}
]
}
}