how-tos

Kling Image 4.0 API: 네이티브 8K 이미지와 롱 웹페이지 디자인

Poyo.ai Team
6 min read
Share:

Kling Image 4.0 API: 네이티브 8K 이미지와 롱 웹페이지 및 이커머스 페이지

Kling Image 4.0 API를 차별화하는 기능은 두 가지입니다. 하나는 kling-4.0-image의 8K 해상도 등급으로, PoYo에서 이 등급을 제공하는 이미지 모델은 이것뿐입니다. 다른 하나는 웹페이지 전체나 이커머스 상세 페이지를 세로로 긴 이미지 한 장으로 디자인하는 별도 모델 kling-4.0-long-image입니다. 이 글에서는 요청 본문, 출시 당일 실행했을 때 받은 결과, 파일 처리 방법을 보여 드립니다. 먼저 플레이그라운드에서 시험해 보려면 Kling Image 4.0 모델 페이지에서 시작하세요.

Kling Image 4.0 API의 네이티브 8K

Kling은 출시 글에서 Kling Image 4.0이 네이티브 8K 이미지 생성을 도입한다고 밝혔습니다. 즉, 나중에 업스케일하는 것이 아니라 처음부터 그 크기로 이미지를 생성합니다. PoYo에서는 필드 하나로 설정합니다.

{
  "model": "kling-4.0-image",
  "input": {
    "prompt": "A rider on a vintage motorbike crossing a desert highway at sunrise, long shadows, dust in the air, cinematic photography",
    "size": "16:9",
    "resolution": "8K",
    "n": 1
  }
}

8K 요청의 반환 결과

PoYo 팀은 2026년 11월 19일 프로덕션 API에서 이 요청 형태(텍스트-이미지, size: "16:9", resolution: "8K", n: 1)를 실행했습니다.

결과값
출력10880×6144 PNG
파일 크기약 128 MB
비용32 크레딧($0.16)
제출부터 결과까지약 3.8분
픽셀 형식불투명한 이미지인데도 RGBA(알파 채널이 있는 PNG)

참고로 PoYo 문서에는 1:1 크기가 2K에서 2048×2048, 8K에서 8192×8192, 4K의 16:9가 5440×3072로 나와 있으며, 일반적인 PNG 크기는 2K, 4K, 8K에서 각각 약 7.5 MB, 27 MB, 100 MB입니다. 같은 세션에서 생성한 2K 16:9 이미지는 2720×1536이었습니다.

해상도 등급 비교

resolution크기 예시이미지당 가격사용 시점
2K2048×2048(1:1), 2720×1536(16:9, 실측)13 크레딧($0.065)웹, 소셜, 초안
4K5440×3072(16:9)19 크레딧($0.095)대형 화면, 적당한 크롭
8K8192×8192(1:1), 10880×6144(16:9, 실측)32 크레딧($0.16)인쇄, 빌보드, 한 프레임에서 촘촘한 크롭

참조는 요청당 1회, 각각 1 크레딧이 추가됩니다.

파이프라인에서 8K 파일 다루기

8K PNG는 썸네일처럼 다루기에는 너무 큽니다. 실무에서 바꿔야 할 점은 다음과 같습니다.

  • callback_url을 사용하세요. 몇 분이 걸리는 요청 때문에 웹 요청을 열어 두면 안 됩니다. 태스크가 완료되거나 실패하면 PoYo가 결과를 여러분의 URL로 POST합니다.
  • 다운로드를 디스크나 오브젝트 스토리지로 스트리밍하세요. 메모리 한도가 작은 서버리스 함수에서 128 MB 본문을 메모리로 읽지 말고, HTTP 클라이언트의 읽기 타임아웃을 늘리세요.
  • 필요 없다면 알파 채널을 제거하세요. 저희가 다운로드한 파일은 불투명한 이미지여도 RGBA였습니다. RGB로, 또는 배포용 JPEG나 WebP로 변환하는 단계는 직접 추가해야 합니다. API에는 출력 형식 필드가 없습니다.
  • 8K 마스터를 보관하고 파생본을 제공하세요. 8K로 한 번 생성한 뒤 웹용으로 리사이즈하세요. 같은 프롬프트로 8K를 다시 생성하면 새로운 이미지가 나오고 요금도 새로 부과됩니다.
  • 세트 예산을 신중하게 잡으세요. n은 이미지당 가격에 곱해집니다. 8K 10장 세트는 320 크레딧($1.60)입니다. PoYo 문서에는 8K 10장 시리즈가 약 30분 걸린다고 나와 있으므로 웹훅을 써야 하는 영역입니다.

기존 이미지를 8K로 업스케일하기

image_urls에 이미지를 전달하고 resolution을 8K로 설정한 뒤, 바뀌면 안 되는 것을 명시하세요.

{
  "model": "kling-4.0-image",
  "input": {
    "prompt": "Recreate @Image1 at full detail. Keep the composition, subject, colors and lighting of @Image1 unchanged.",
    "image_urls": ["https://example.com/product-hero.png"],
    "resolution": "8K"
  }
}

이것은 픽셀 업스케일러가 아니라 참조를 바탕으로 한 새로운 생성이므로, 정확히 유지되어야 하는 것은 모두 설명하세요. 비용: 32 + 1 = 33 크레딧($0.165).

kling-4.0-long-image로 만드는 롱 페이지

Kling은 이커머스 상품 상세 페이지와 웹 디자인을 위한 롱폼 생성을 소개하며, 완성된 레이아웃을 이미지 한 장으로 제공한다고 설명합니다. PoYo에서는 skill 필드를 가진 별도의 모델 ID입니다. 출력은 PNG 1장이며 너비는 1K에서 1024 px, 2K에서 2048 px이고, 높이는 콘텐츠에 따라 정해집니다.

웹페이지 디자인

{
  "model": "kling-4.0-long-image",
  "input": {
    "prompt": "A landing page for a specialty coffee roastery: hero with coffee beans, story section, three featured blends with prices, brewing guide, customer reviews and footer. Warm earthy palette. All text on the page is in English.",
    "skill": "webpage",
    "resolution": "1K"
  }
}

webpage의 선택 입력:

필드프롬프트 태그효과
style_image_url@StyleImage디자인이 이 이미지의 시각 및 레이아웃 스타일을 따름
subject_image_url@SubjectImage이 이미지에 담긴 피사체를 중심으로 디자인 구성

측정 결과: 1K의 webpage 요청은 약 1.7–2.2분 만에 1024×4257 페이지 1장을 반환했고 비용은 110 크레딧($0.55)입니다(PoYo 프로덕션 API, 2026년 11월 19일).

페이지 문구의 언어를 지정하세요

모든 롱 이미지 프롬프트에 꼭 추가해야 할 한 가지입니다. 테스트에서 첫 웹페이지 요청은 페이지 텍스트의 언어를 지정하지 않은 영어 프롬프트를 사용했고, 페이지에는 중국어 문구가 들어갔습니다. 다음 실행에서 프롬프트에 "All text on the page is in English." 문장을 추가하자 해결되었습니다. 다시 실행할 때마다 전체 요금(1K 웹페이지는 110 크레딧)이 부과되므로, 페이지에 필요한 언어가 무엇이든 처음부터 프롬프트 템플릿에 언어 지정 문장을 넣으세요. Kling은 텍스트 렌더링 언어로 영어, 중국어 간체와 번체, 일본어, 한국어, 스페인어, 포르투갈어를 제시합니다.

이커머스 상세 페이지

skill: "ecommerce"는 @Image1–@Image3로 지칭되는 상품 사진 1–3장으로 상품 상세 페이지를 만듭니다.

{
  "model": "kling-4.0-long-image",
  "input": {
    "prompt": "Design a product detail page for the insulated water bottle in @Image1: hero shot, key features, capacity and size, materials, and lifestyle scenes. All text on the page is in English.",
    "skill": "ecommerce",
    "image_urls": ["https://example.com/water-bottle.png"],
    "length": "medium",
    "resolution": "1K"
  }
}

length는 페이지의 섹션 수와 가격을 결정합니다.

length섹션 수(대략)1K2K
short2–547 크레딧($0.235)57 크레딧($0.285)
medium(기본값)6–1094 크레딧($0.47)110 크레딧($0.55)
long11–18157 크레딧($0.785)173 크레딧($0.865)

상품 사진마다 1 크레딧이 추가됩니다. PoYo 문서는 이런 페이지가 얼마나 길어지는지 보여 주는 예로 2K의 long 페이지를 들며, 최대 2048×54,941 px, 약 87 MB입니다.

롱 이미지 표시와 분할

너비 1024 px에 높이가 수천 픽셀인 페이지는 일반 이미지 미리보기에 들어가지 않습니다. 검토용으로는 섹션이나 화면 높이 단위 타일로 잘라 쓰고, 원본은 다운로드용으로 보관하세요. 결과물은 디자인 시안으로 다루세요. 텍스트, 가격, 버튼은 HTML이 아니라 픽셀입니다.

8K와 롱 페이지를 위한 프롬프트 체크리스트

  • 이미지 안 텍스트의 언어를 명시하세요.
  • 페이지는 섹션을 순서대로 나열하세요: 히어로, 기능, 사양, 리뷰, 푸터.
  • 정확한 문구는 따옴표로 묶고 위치를 지정하세요. Kling에 따르면 모델은 이미지당 최대 2,000자를 렌더링합니다.
  • 8K에서는 크롭 후에도 살아남아야 할 질감과 세부 묘사를 설명하세요.
  • 참조에는 태그마다 역할을 부여하세요: "@Image1 is the product, keep its shape and label".

전체 요청 레퍼런스와 폴링 코드: Kling Image 4.0 API 가이드. 비용: Kling Image 4.0 API 가격. 두 모델 ID의 배경: Kling Image 4.0이란.

자주 묻는 질문

Kling Image 4.0 API는 정말 8K로 출력하나요? 네. resolution: "8K"로 실행한 16:9 테스트는 10880×6144 PNG를 반환했고, PoYo 문서에는 1:1에서 8192×8192로 나와 있습니다. Kling은 이를 네이티브 8K 생성이라고 설명합니다.

8K Kling Image 4.0 API 요청은 얼마나 걸리나요? 출시 당일 테스트에서 16:9 8K 이미지 1장에 약 3.8분이 걸렸습니다. 더 큰 세트는 훨씬 오래 걸리므로 callback_url을 사용하세요.

Kling Image 4.0 API로 8K 이미지를 만드는 데 비용은 얼마인가요? PoYo에서 이미지당 32 크레딧($0.16)이며 참조마다 1 크레딧이 추가됩니다.

Kling Image 4.0 롱 이미지 API는 어떤 크기를 반환하나요? 너비는 1K에서 1024 px, 2K에서 2048 px이고 높이는 콘텐츠에 따라 달라집니다. 저희의 1K 웹페이지는 1024×4257이었습니다.

Kling Image 4.0 롱 페이지의 텍스트가 왜 엉뚱한 언어로 나왔나요? 프롬프트에서 언어를 지정하지 않았기 때문입니다. "All text on the page is in English." 같은 문장을 추가하세요.

Share: