· reAPI Team
Kling Image 4.0 Long Image 튜토리얼
모드 규칙, 참조 ID, 요금 및 점검 단계와 함께 reAPI에서 이커머스 상세페이지와 웹페이지 레이아웃을 위해 Kling Image 4.0 Long Image를 사용하는 방법을 알아보세요.

대부분의 이미지 생성기는 한 번에 정사각형 또는 16:9 프레임 한 장씩만 생성합니다. 전체 이커머스 상품 상세페이지나 연속된 세로형 랜딩 페이지가 필요할 때 여섯 장의 개별 스틸 이미지를 이어 붙이면 거의 항상 모든 이음새에서 조명, 여백 및 타이포그래피가 어긋납니다. Kling Image 4.0 Long Image는 단일 요청으로 상단 히어로에서 푸터까지 이어지는 하나의 연속된 세로형 PNG를 렌더링해 이 문제를 해결합니다.[1]
이 튜토리얼에서는 참조 이미지 규칙, @id 지정, 1K 대비 2K 해상도 계획, 2026년 11월 20일 기준 최신 reAPI 페이지당 요금, 그리고 세로형 PNG 파일에 필요한 폴링 및 파일 점검 절차를 포함해 webpage 및 ecommerce 모드의 정확한 reAPI 계약을 살펴봅니다.[2]
핵심 요약
- 두 가지 별도 스킬: 모든 호출에서
settings.skill은 필수입니다. 전체 스크롤 랜딩 페이지 콘셉트에는webpage(선택적 참조 이미지 02개,3장 및settings.length생략)를, 상품 상세페이지에는ecommerce(필수refer_image사진 1short,medium또는long길이)를 선택하세요.[1] - 작업당 세로형 PNG 1장: 출력 너비는 1K(1024px) 또는 2K(2048px)로 고정되며, 세로 높이는 브리프의 섹션에 맞춰 자동 조정됩니다.
4k는 지원되지 않습니다.[2] - 참조 역할 혼용 불가:
refer_image는ecommerce모드에서만 작동하며,style_refer_image및subject_refer_image는webpage모드에서만 작동합니다. element 참조는 지원되지 않습니다.[2] - 페이지당 종량제 과금: 2026년 11월 20일 확인 기준 reAPI 요금은 $0.2269(
ecommerce,short,1k)부터 $0.8319(ecommerce,long,2k)까지이며,webpage는 $0.5294(1k) 또는 $0.5748(2k)이고 첫 번째 이미지를 포함해 입력 참조 이미지당 $0.003025가 추가됩니다. 실시간 요금표를 확인하세요.[3] - 긴 렌더링 시간 및 대용량 파일 대비: 다중 섹션 렌더링에는 보통 몇 분이 걸리며, 2K 세로형 PNG는 50 MB를 초과할 수 있습니다. 이에 맞춰 HTTP 다운로드 타임아웃과 이미지 뷰어를 준비하세요.[2]
1K 웹페이지 브리프 한 건으로 시작하기
여러 장의 상품 사진을 업로드하거나 2K long 레이아웃 비용을 지불하기 전에, 먼저 텍스트만 포함한 webpage 요청 한 건을 1K 너비로 Kling Image 4.0 Long Image에 보내 보세요. 1K 웹페이지 작업은 고해상도 픽셀이나 참조 이미지 설정에 추가 시간을 쓰지 않고도 세로 섹션 호흡, 색상 대비 및 시각적 위계를 검증하는 데 유용합니다.
하나의 prompt 항목 안에 위에서 아래 순서대로 모든 섹션을 정확히 나열하세요. 히어로 배너, 중간 기능 밴드, 그리드 또는 비교 스트립, 그리고 마지막 푸터 블록까지 이름을 붙입니다. "모던한 커피 웹사이트 만들기"처럼 모호하게 요청하면 섹션 수와 시각적 리듬이 임의로 정해지지만, 번호가 매겨진 세로 개요를 제공하면 결과물을 검토할 때 구체적인 체크리스트로 활용할 수 있습니다.
curl https://reapi.ai/api/v1/images/generations \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "kling-image-4-0-long-image",
"contents": [
{
"type": "prompt",
"text": "Design a tall landing page for a specialty coffee roastery. Section 1: full-bleed hero banner with warm morning light over a pour-over bar and headline space on the left. Section 2: three single-origin bean cards with origin notes and roast level tags. Section 3: brewing guide strip showing grind size, water temperature, and pour timing. Section 4: minimal footer with cafe address and opening hours."
}
],
"settings": {
"skill": "webpage",
"resolution": "1k"
}
}'엔드포인트는 작업 id와 status: "processing"이 포함된 JSON 객체를 반환합니다. 해당 ID를 즉시 저장하세요. 10초 만에 완료되는 단일 타일 이미지 엔드포인트와 달리, 연속된 다중 섹션 레이아웃은 렌더링에 더 오래 걸립니다. status가 completed 또는 failed로 바뀔 때까지 동일한 베어러 키로 GET /api/v1/tasks/{id}를 폴링하세요.[4]
Kling Image 4.0 Long Image에서 ecommerce 또는 webpage 모드 선택하기
Kling Image 4.0 Long Image에 보내는 모든 요청에는 settings.skill이 필요합니다. 각 스킬이 고유한 참조 유형과 길이 제어를 강제하며 이를 섞어 쓰면 과금 전에 유효성 검사 오류가 발생하므로 올바른 모드를 선택하는 것이 중요합니다.[2]
| 규칙 | ecommerce 모드 | webpage 모드 |
|---|---|---|
| 목표 출력물 | 다중 섹션 상품 상세페이지 | 전체 스크롤 웹페이지 비주얼 레이아웃 |
| 허용 참조 유형 | refer_image만 가능 | style_refer_image 및 subject_refer_image만 가능 |
| 참조 이미지 수 | 1~3장 필수 | 스타일 0 |
settings.length | short, medium(기본값) 또는 long | 무시됨(요청에서 생략) |
settings.resolution | 1k(기본값) 또는 2k | 1k(기본값) 또는 2k |
options.watermark_info.enabled | false만 가능 | false만 가능 |
실제 상품 사진이 이미 준비되어 있고 온라인 스토어용 일관된 세로형 상세 시트가 필요할 때마다 Kling Image 4.0 Long Image에서 ecommerce 모드를 사용하세요. 세 가지 길이 등급은 제작사가 문서화한 대략적인 섹션 수에 대응합니다. short는 약 25개 섹션, 10개 섹션, medium은 약 6long은 약 11~18개 섹션을 목표로 합니다.[1]
순수 텍스트 카피로 시작하거나 시각적 스타일 참조 이미지 1장과 히어로 피사체 사진 1장을 결합해 브랜드 랜딩 페이지, 출시 페이지 또는 에디토리얼 마이크로사이트의 프로토타입을 만들 때는 Kling Image 4.0 Long Image에서 webpage 모드를 사용하세요. webpage 모드는 length 열거형 대신 섹션 목록으로 세로 깊이를 결정하므로 settings.length를 생략하면 요청을 깔끔하고 스키마에 맞게 유지할 수 있습니다.
유효성 검사를 통과하도록 이름 지정 참조 연결하기
참조 이미지는 Kling Image 4.0 Long Image 스크롤 전반에서 실제 상품이 일관되게 인식되도록 유지하는 핵심 수단입니다. contents의 각 참조 항목에는 type, 공개적으로 접근 가능한 HTTP 또는 HTTPS url, 그리고 선택적 고유 id가 포함됩니다. Base64 문자열과 data: URI는 reAPI 게이트웨이에서 거부됩니다.[2]
제출하기 전에 모든 참조 파일은 다음 네 가지 형식 검사를 충족해야 합니다.
- 파일 형식: JPEG 또는 PNG만 지원합니다.
- 파일 크기: 이미지당 최대 30 MB입니다.
- 최소 해상도: 가로와 세로 모두 최소 300픽셀 이상이어야 합니다.
- 화면비: 2:5~5:2 사이여야 합니다.
엔드포인트를 호출하기 전에 로그아웃한 브라우저 창에서 각 참조 링크를 확인하세요. 만료되는 대시보드 쿠키 뒤에 있는 에셋 URL은 렌더링 워커가 파일을 가져올 때 실패합니다.
이커머스 상품 상세페이지 예시
Kling Image 4.0 Long Image ecommerce 모드에서는 1~3개의 refer_image 항목을 제공하고 각 앵글에 front, spout처럼 명확하고 짧은 id를 부여하세요. 프롬프트에서 해당 이름을 @front, @spout처럼 직접 인용하면 레이아웃이 어느 사진으로 히어로 배너를 고정하고 어느 사진으로 근접 콜아웃 밴드를 구성할지 인식할 수 있습니다.
{
"model": "kling-image-4-0-long-image",
"contents": [
{
"type": "refer_image",
"url": "https://example.com/kettle-front.png",
"id": "front"
},
{
"type": "refer_image",
"url": "https://example.com/kettle-spout.jpg",
"id": "spout"
},
{
"type": "prompt",
"text": "Build a medium ecommerce product detail page for the brushed-steel gooseneck kettle in @front. Section 1: full-bleed hero showing @front on warm travertine stone with clean headline space. Section 2: three core benefit callouts covering pour precision, balanced handle ergonomics, and stainless body durability. Section 3: close-up detail band highlighting the curved spout from @spout with flow-control annotations. Section 4: morning pour-over brewing lifestyle scene. Section 5: care instructions and verified specification list."
}
],
"settings": {
"skill": "ecommerce",
"length": "medium",
"resolution": "2k"
}
}웹페이지 스타일 및 피사체 참조 예시
Kling Image 4.0 Long Image webpage 모드에서는 미적 방향성과 제품 자체를 분리하세요. 색상 팔레트, 그리드 리듬 및 타이포그래피 분위기를 안내하려면 최대 1장의 style_refer_image를 첨부하고, 실제 사물을 정확하게 유지하려면 최대 1장의 subject_refer_image를 첨부하세요. 요청 내 모든 id는 고유해야 합니다.
{
"model": "kling-image-4-0-long-image",
"contents": [
{
"type": "style_refer_image",
"url": "https://example.com/editorial-grid.png",
"id": "layout"
},
{
"type": "subject_refer_image",
"url": "https://example.com/watch.jpg",
"id": "watch"
},
{
"type": "prompt",
"text": "Design a tall watch launch webpage that matches the pale sandstone palette and editorial grid rhythm of @layout while showcasing @watch. Section 1: hero header featuring @watch at center-right. Section 2: three-column craft overview covering case finish, crystal clarity, and strap taper. Section 3: close-up dial and lug detail strip. Section 4: full technical specifications grid and clean minimal footer."
}
],
"settings": {
"skill": "webpage",
"resolution": "2k"
}
}긴 브리프를 작성할 때는 가중 프롬프트 제한에 유의하세요. Kling Image 4.0 Long Image는 영문 최대 166,000자 또는 비영문 최대 71,000자를 허용하며, 혼합 언어 텍스트는 english / 166000 + non_english / 71000 <= 1 조건으로 제한됩니다. @id 이름이 위치 마커로 매핑된 후에도 이 제한이 다시 검사되므로 프롬프트가 상한선에 가깝다면 약간의 여유를 두세요.[2]
1K, 2K 및 길이 등급별 예산 계획하기
출력 타일당 과금하는 일반 스틸 이미지 생성기와 달리, Kling Image 4.0 Long Image는 완료된 각 요청에 대해 출력 등급 요금 1건과 첫 번째 참조 이미지를 포함한 입력 참조 이미지당 요금 1건씩을 합산해 과금합니다. 출력물을 전달하지 않고 실패한 생성 건은 예약된 크레딧이 자동으로 반환됩니다.[2]
아래 표는 2026년 11월 20일 확인 기준 reAPI의 현재 요금(1 크레딧 = $0.001 USD, $1 = 1,000크레딧)입니다. 대량 배치를 실행하기 전에는 반드시 Kling Image 4.0 Long Image 요금 페이지에서 활성 요금을 확인하세요.[3]
| 등급 | 해상도 | reAPI 요금(2026년 11월 20일 확인) | 주요 용도 |
|---|---|---|---|
ecommerce · short | 1k / 2k | $0.2269 / $0.2723 | 간결한 2~5개 섹션 상품 요약 페이지 |
ecommerce · medium | 1k / 2k | $0.4538 / $0.5294 | 표준 6~10개 섹션 스토어프론트 상세페이지 |
ecommerce · long | 1k / 2k | $0.7563 / $0.8319 | 전체 11~18개 섹션 플래그십 상품 시트 |
webpage | 1k / 2k | $0.5294 / $0.5748 | 전체 스크롤 랜딩 페이지 또는 캠페인 레이아웃 |
| 입력 참조 이미지 | 모든 해상도 | 각 $0.003025 | 제공된 참조 사진 1장당 1회 청구 |
2026년 11월 20일 요금을 적용한 구체적인 계산 예시는 다음과 같습니다. 상품 사진 2장이 포함된 ecommerce medium 2k 요청의 총비용은 $0.5294 + 2 × $0.003025 = $0.53545입니다. 제출 시 reAPI는 정수 크레딧 ceil(0.53545 × 1000) = 536개를 예약한 뒤, 완료 시 정확한 마이크로달러 단위로 정산해 소수점 차액을 잔액으로 돌려드립니다.[2]
Kling Image 4.0 Long Image 지출을 관리하는 실용적인 방법은 2단계 워크플로입니다. 먼저 1k(또는 상품 재현도를 우선 검증할 때는 ecommerce short 1k)로 레이아웃 순서와 섹션 구성을 초안으로 작성해 모든 밴드를 검토하고, 시각적 시퀀스가 확정된 후에만 2k로 올리세요.
안정적으로 폴링하고 세로형 PNG 출력 점검하기
Kling Image 4.0 Long Image 요청을 제출한 후에는 510초와 같은 일정한 간격으로 20분 이상으로 설정하세요. 폴링 요청이 일시적으로 실패하더라도 GET /api/v1/tasks/{id}를 폴링하며, long + 2k 작업의 경우 클라이언트 타임아웃 예산을 최소 15POST /v1/images/generations를 자동 재시도하지 마세요. 새 POST 요청마다 과금 대상 작업이 새로 생성됩니다.[4]
status가 completed에 도달하면 output.image_urls[0]에서 단일 URL을 읽어 즉시 자체 스토리지로 PNG를 복사하세요. 2K 세로형 레이아웃은 50 MB를 넘고 세로 길이가 15,000픽셀을 초과할 수 있으므로 작은 서버리스 함수 메모리에 전체 파일을 버퍼링하지 말고 디스크로 스트리밍 다운로드한 뒤 두 단계로 결과를 점검하세요.
- 전체 높이 썸네일 스캔: 화면을 축소해 위에서 아래까지의 시각적 리듬, 색상 일관성 및 섹션 간 명확한 구분을 확인하세요.
- 섹션별 100% 확대 크롭 검토: 실제 픽셀 배율에서 히어로 헤드라인, 상품 실루엣, 소재 마감, 콜아웃 라벨 및 하단 사양 블록을 점검하세요.
브리프에는 검증된 제품 치수, 보증 조건 및 기술 사양만 포함하세요. 100% 확대 배율로 문구 정확도를 점검하면 레이아웃이 스토어프론트 이미지 슬라이싱이나 프론트엔드 개발 단계로 넘어가기 전에 왜곡된 숫자나 누락된 글자를 잡아낼 수 있습니다.
자주 묻는 질문
Kling Image 4.0 Long Image로 4K 세로 페이지를 생성할 수 있나요?
아니요. Kling Image 4.0 Long Image는 1k(너비 1024px) 및 2k(너비 2048px) 출력만 지원합니다. 4k를 지정한 요청은 크레딧이 예약되기 전에 유효성 검사 오류로 거부됩니다. 4K 개별 스틸 이미지나 다중 컷 세트를 생성하려면 Kling Image 4.0을 사용하세요.
참조 이미지가 0개일 때 ecommerce 요청이 유효성 검사에 실패한 이유는 무엇인가요?
ecommerce 모드는 모델이 모든 세로 섹션을 실제 상품 사진에 기반해 생성할 수 있도록 contents에 1~3개의 refer_image 항목이 필수입니다. 텍스트만으로 세로형 레이아웃을 생성하려면 settings.skill을 webpage로 설정하세요.
하나의 요청에 refer_image와 style_refer_image를 함께 사용할 수 있나요?
아니요. 참조 역할은 모드에 따라 엄격히 분리되어 있습니다. ecommerce는 refer_image만 허용하며, webpage는 style_refer_image와 subject_refer_image만 허용합니다. 플레이그라운드에서는 제출 전에 차단되며, API로 직접 전송하면 크레딧이 먼저 예약된 뒤 비동기 처리 단계에서 실패하고 예약된 크레딧이 자동으로 환불됩니다.
첫 번째 참조 이미지도 요금에 포함되나요?
네. contents에 제공된 모든 입력 참조 이미지는 완료된 작업에서 첫 번째 이미지부터 1회씩 과금됩니다. 출력물 없이 실패한 작업은 예약된 크레딧이 자동으로 반환됩니다.
Kling Image 4.0 Long Image는 Kling Image 4.0과 어떻게 다른가요?
Kling Image 4.0 Long Image는 세로형 이커머스 상세페이지와 웹페이지 레이아웃에 맞춰진 단일 연속 세로형 PNG를 출력합니다. Kling Image 4.0은 2K 또는 4K 해상도로 표준 화면비 스틸 이미지(독립적인 후보 이미지 최대 9장 또는 2~10컷 시리즈)를 출력합니다.
50 MB 세로형 PNG 출력 다운로드는 어떻게 처리해야 하나요?
HTTP 다운로드 타임아웃을 60초 이상으로 설정하고, 응답 바이트를 오브젝트 스토리지나 디스크로 직접 스트리밍하며, 이미지 슬라이싱 스크립트를 실행하기 전에 다운로드 후 Content-Length 또는 PNG 해상도를 확인하세요.
Kling Image 4.0 Long Image 프로덕션 적용하기
먼저 Kling Image 4.0 Long Image 플레이그라운드에서 1k 웹페이지 프롬프트 한 건을 테스트해 섹션 호흡과 시각적 균형을 점검하세요. 세로 개요가 스토어프론트나 캠페인 구조와 일치하면 참조 URL을 확정하고, Kling Image 4.0 Long Image API 문서의 스키마를 따른 뒤, output.image_urls[0]을 중심으로 반복 가능한 폴링 및 슬라이싱 파이프라인을 구축하세요.
참고 자료
- Kling AI, Kling Image 4.0 Long Image Generation API — 공식
ecommerce및webpage스킬 사양, 길이 등급 안내 및 참조 이미지 제한. - reAPI, Kling Image 4.0 Long Image API 문서 — 요청 스키마, HTTP(S) 참조 제약 조건, 가중 프롬프트 제한, 출력 스키마 및 과금 방식.
- reAPI, Kling Image 4.0 Long Image 모델 페이지 및 실시간 요금 — 2026년 11월 20일 기준 등급별 출력 및 참조 이미지당 요금.
- reAPI, Tasks API 레퍼런스 — 비동기 작업 폴링, 종료 상태 및 오류 처리.