Kling Image 4.0 긴 이미지 생성
웹페이지 디자인이나 상품 상세 페이지용 긴 이미지를 1K 또는 2K로 생성
중국 본토 사용자 안내: 중국 본토 사용자는 https://toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://toapis.com 을 https://toapis.cn 로 바꿔 주세요.
kling-image-4.0-long은 요청마다 긴 이미지 한 장을 비동기로 생성합니다. 웹페이지 디자인은 webpage, 쇼핑몰 상품 상세 이미지는 ecommerce를 선택하세요.
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.0-longkling-image-4.0-long을 지정합니다.
promptstring본문필수생성할 레이아웃과 내용을 설명합니다. 공백 이외의 문자가 필요합니다.
skillstring본문필수webpage는 웹페이지 디자인을, ecommerce는 쇼핑몰 상품 상세 이미지를 생성합니다.
resolutionstring본문기본값: 1K1K 또는 2K를 지정합니다. 대소문자를 구분하지 않습니다.
ninteger본문기본값: 1생성할 이미지 수입니다. 1로 고정됩니다. 이 필드를 생략하거나 정수 1을 지정하세요.
lengthstring본문ecommerce에서만 사용합니다. short는 콘텐츠 섹션 약 2-5개, medium(기본값)은 약 6-10개, long은 약 11-18개입니다. 모든 섹션은 한 장의 이미지에 담깁니다.
image_urlsstring[]본문ecommerce에서는 이 필드 또는 reference_images에 상품 참조 이미지 1~3장을 순서대로 지정해야 합니다. 프롬프트의 @image_1, @image_2, @image_3은 배열 순서에 따라 각 이미지를 가리킵니다.
reference_imagesstring[]본문ecommerce에서 image_urls 대신 사용할 수 있습니다. 두 필드 중 하나만 지정하세요.
style_reference_image_urlstring본문webpage에서만 사용하는 선택 필드입니다. 시각적 스타일에 참고할 이미지 URL을 하나 지정할 수 있습니다.
subject_reference_image_urlstring본문webpage에서만 사용하는 선택 필드입니다. 주제에 참고할 이미지 URL을 하나 지정할 수 있습니다.
callback_urlstring본문작업이 끝났을 때 알림을 받을 URL입니다. 토큰 작업 웹훅을 설정한 경우 기본 URL과 같은 스킴, 호스트, 포트를 사용해야 합니다. 생략하면 토큰에서 활성화된 기본 URL을 사용합니다.
참조 이미지는 서비스에서 접근 가능한 HTTP(S) URL이어야 합니다. 로컬 파일의 URL은 이미지 업로드 API로 발급받을 수 있습니다.
파라미터 제한
webpage에서는 length, image_urls, reference_images를 생략하세요. 빈 배열이나 null도 허용되지 않습니다. 두 종류의 참조 이미지 URL을 모두 생략하면 텍스트만으로 생성합니다. ecommerce에서는 style_reference_image_url과 subject_reference_image_url을 생략하세요.
size, aspect_ratio, ratio, series_amount, result_type, contents, options, settings는 생략하세요.
작업 조회
응답의 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"과금
기본 요금은 요청 건별로 청구되며 요금 지역, skill, resolution에 따라 달라집니다. ecommerce는 length도 요금에 영향을 줍니다. 같은 API 키로 GET /v1/pricing?model=kling-image-4.0-long을 조회하세요. 중국 본토 요금표는 ®ion=cn, 글로벌 요금표는 ®ion=global을 추가하세요. 생략 시 API 도메인에 관계없이 기본값은 global입니다.
해당 요금 항목에 input_image_unit_price가 있으면 free_input_image_count를 초과하는 참조 이미지에 장당 추가 요금이 부과됩니다. 확정된 청구 금액은 작업의 billing에서 확인할 수 있습니다. 자세한 내용은 실제 비용 및 작업 사용량을 참고하세요.
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-long",
"prompt": "도예 공방의 세로로 긴 랜딩 페이지를 디자인해 주세요. 스타일 참조 이미지의 분위기를 살리고, 주제 참조 이미지의 수제 머그잔을 중심에 배치해 주세요. 수업 일정과 예약 섹션을 넣어 주세요.",
"skill": "webpage",
"n": 1,
"resolution": "1K",
"style_reference_image_url": "https://example.com/pottery-style.png",
"subject_reference_image_url": "https://example.com/handmade-mug.png"
}'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-long",
"prompt": "@image_1의 책상용 조명에 대한 긴 상품 상세 이미지를 만들어 주세요. 조작 버튼의 확대 이미지로 @image_2를 사용하고, 밝기 설정과 제품 크기, 구성품을 소개해 주세요.",
"skill": "ecommerce",
"n": 1,
"resolution": "2K",
"length": "medium",
"image_urls": [
"https://example.com/desk-lamp.png",
"https://example.com/lamp-controls.png"
]
}'응답 예시
{
"id": "tsk_img_example",
"object": "generation.task",
"model": "kling-image-4.0-long",
"status": "queued",
"progress": 0,
"created_at": 1794960000,
"metadata": {}
}{
"id": "tsk_img_example",
"object": "generation.task",
"model": "kling-image-4.0-long",
"status": "completed",
"progress": 100,
"created_at": 1794960000,
"metadata": {},
"result": {
"type": "image",
"data": [
{
"url": "https://example.com/generated/kling-image-4.0-long.png"
}
]
}
}