
Kling Image 4.0 API(kling-4.0-image)는 PoYo에서 Kling O3 Image API(kling-o3-image, kling-o3-image-edit)의 후속 모델입니다. 요약하면 Kling Image 4.0은 8K, 이미지 세트, 50,000자 프롬프트, 별도의 롱 페이지 모델을 추가했고, 이미지당 비용은 약 3–4배입니다. 이 글은 두 모델을 요청 단위로 비교해 어떤 호출을 옮길지 판단할 수 있도록 돕습니다. 둘 다 PoYo에서 사용할 수 있습니다: Kling Image 4.0, Kling O3 Image.
한 장의 표로 보는 결정 기준
| 요청에 필요한 것이… | 호출할 모델 |
|---|---|
| 1K 출력, 또는 이미지당 최저가 | kling-o3-image / kling-o3-image-edit |
| API에서 바로 받는 JPEG 또는 WebP | Kling O3 Image(output_format) |
| 4K 초과, 또는 정확히 8K | kling-4.0-image |
| 같은 피사체와 스타일을 가진 2–10장 세트 | enable_sequential을 켠 kling-4.0-image |
| 2,000자보다 긴 프롬프트 | kling-4.0-image(최대 50,000자) |
| 웹페이지 전체나 이커머스 상세 페이지를 이미지 한 장으로 | kling-4.0-long-image |
| 하나의 모델 ID로 텍스트-이미지와 편집 모두 | kling-4.0-image |
필드별 요청 차이
두 모델 모두 POST https://api.poyo.ai/api/generate/submit, 같은 상태 엔드포인트, 같은 callback_url을 사용합니다. 차이는 model과 input에 있으며, 아래 내용은 각 모델의 PoYo 문서에서 가져왔습니다.
| 필드 | Kling O3 Image | Kling Image 4.0 API |
|---|---|---|
model | kling-o3-image(텍스트-이미지), kling-o3-image-edit(편집) | 둘 다 kling-4.0-image, image_urls가 있으면 편집 모드 |
prompt | 최대 2,000자 | 1–50,000자 |
image_urls | 1–10개, kling-o3-image-edit에서 필수 | 1–10개(선택), 각각 30 MB, ≥300 px, 비율 0.4–2.5 |
| 엘리먼트 | elements: [{frontal_image_url, reference_image_urls}] | kling_elements: [{element_input_urls: [front, …]}], 시점 2–4개, 최대 7개, 이미지 + 엘리먼트 ≤ 10 |
resolution | 1K(기본값), 2K, 4K | 2K(기본값), 4K, 8K |
size | 8가지 비율, 기본값 16:9, auto는 편집 모델에서만 | 같은 8가지 비율과 auto, 기본값 auto |
output_format | jpeg, png(기본값), webp | 지원 안 함, PNG만 |
n | 1–9 | 독립 1–9, 또는 enable_sequential: true로 2–10 |
enable_sequential | 지원 안 함 | true면 순서가 있는 일관된 세트 반환 |
| 롱 페이지 | 지원 안 함 | 별도 모델 kling-4.0-long-image |
Kling은 출시 글에서 Kling Image 4.0을 네이티브 8K 생성을 지원하는 첫 모델로, 프롬프트 하나로 최대 10장을 기획하고 일곱 개 언어로 최대 2,000자의 텍스트를 렌더링할 수 있다고 소개했습니다. 이는 Kling의 주장이며, 코드에서 실제로 바뀌는 것은 위의 API 차이입니다.
같은 요청 기준 가격
PoYo 가격, 1 크레딧 = $0.005 기준입니다. PoYo에서 Kling O3 Image는 참조 추가 요금이 없고, Kling Image 4.0 API는 참조 이미지나 엘리먼트마다 요청당 1회 1 크레딧이 추가됩니다. Kling의 가격 페이지에도 같은 변화가 명시되어 있습니다. Kling Image 4.0은 참조 입력에 과금하고, 이전 모델은 과금하지 않았습니다.
| 같은 요청 | Kling O3 Image | Kling Image 4.0 API |
|---|---|---|
| 이미지 1장, 1K | 3.5 크레딧($0.0175) | 미제공(최소 2K: 13 크레딧) |
| 이미지 1장, 2K | 3.5 크레딧($0.0175) | 13 크레딧($0.065) |
| 이미지 1장, 4K | 7 크레딧($0.035) | 19 크레딧($0.095) |
| 이미지 1장, 8K | 미제공 | 32 크레딧($0.16) |
| 2K 편집, 참조 이미지 2장 + 엘리먼트 1개 | 3.5 크레딧($0.0175) | 16 크레딧($0.08) |
| 2K 이미지 4장 | 14 크레딧($0.07), 독립 | 52 크레딧($0.26), 세트 또는 독립 |
| 웹페이지 디자인, 1K | 미제공 | 110 크레딧($0.55) |
이미지당 Kling Image 4.0 API는 2K에서 Kling O3 Image의 약 3.7배, 4K에서 약 2.7배입니다. Kling Image 4.0 전체 가격표는 Kling Image 4.0 API 가격에 있습니다.
달라지는 제한
- 최저 해상도가 올라갑니다. 1K가 없어졌고 Kling Image 4.0의 최소 출력은 2K입니다. 썸네일을 제공한다면 O3를 유지하거나 직접 리사이즈하세요.
- 최고 해상도가 8K로 올라갑니다. PoYo 문서에는 1:1에서 8192×8192로 나와 있습니다. 출시 당일 테스트(PoYo 프로덕션 API, 2026년 11월 19일)에서 16:9 8K 요청은 약 128 MB의 10880×6144 PNG를 반환했고, 약 3.8분이 걸렸으며 비용은 32 크레딧입니다.
- 파일 처리.
output_format이 없으므로 PNG를 받습니다. 저희가 다운로드한 파일은 불투명한 이미지여도 RGBA PNG였습니다. O3에서jpeg나webp를 썼다면 변환과 스토리지를 계획하세요. - 참조 규칙이 명시적입니다. Kling Image 4.0은 각 참조를 검증합니다. 최대 30 MB, 각 변 최소 300 px, 너비/높이 0.4–2.5입니다. O3 문서에는 이런 제한이 없으므로, 마이그레이션 전에 아주 넓거나 작은 이미지를 검증하세요.
- 세트는 더 오래 걸립니다. 2K 이미지 4장 세트는 약 4.9분이 걸렸습니다. 길거나 큰 작업은
callback_url로 옮기세요.
언제 전환해야 할까
O3로는 할 수 없는 것, 즉 8K, 일관된 세트, 긴 프롬프트, 페이지 디자인이 필요한 호출을 kling-4.0-image로 전환하세요. 예를 들면 다음과 같습니다.
- 스토리보드와 제품 앵글. O3에서는
n: 4를 보내고 피사체가 일치하길 기대할 수밖에 없습니다.enable_sequential: true를 쓰면 모델이 세트를 기획하며, 저희 테스트에서는 새벽, 정오, 일몰, 밤에 걸쳐 같은 라이더, 바이크, 의상이 유지되었습니다. - 인쇄용 및 크롭이 많은 에셋. 4K를 넘는 모든 것.
- 길고 구조화된 프롬프트. 2,000자를 넘는 브랜드 가이드, 샷 리스트, 카피 블록.
- 이커머스 페이지.
kling-4.0-long-image는 상세 페이지 전체를 만들며, O3에는 이에 해당하는 기능이 없습니다.
대량의 1K–2K 초안, 썸네일, API에서 JPEG나 WebP가 필요한 파이프라인은 O3에 남겨 두세요. 둘 다 쓰는 것도 괜찮습니다. 같은 키로 O3에서 탐색하고 Kling Image 4.0으로 최종 세트를 만들면 됩니다.
마이그레이션 diff
텍스트-이미지 호출:
{
- "model": "kling-o3-image",
+ "model": "kling-4.0-image",
"input": {
"prompt": "A cinematic futuristic alley with rain and neon reflections",
"resolution": "4K",
"size": "16:9",
- "output_format": "png",
"n": 2
}
}
엘리먼트를 쓰는 편집입니다. 필드 이름 변경 두 가지와 모델 ID 통합 한 가지가 있습니다.
{
- "model": "kling-o3-image-edit",
+ "model": "kling-4.0-image",
"input": {
"prompt": "Place @Element1 sitting on the sofa in @Image1. Keep the room layout of @Image1 unchanged.",
"image_urls": ["https://example.com/living-room.png"],
- "elements": [
- {
- "frontal_image_url": "https://example.com/character-front.png",
- "reference_image_urls": ["https://example.com/character-side.png"]
- }
- ],
+ "kling_elements": [
+ {
+ "element_input_urls": [
+ "https://example.com/character-front.png",
+ "https://example.com/character-side.png"
+ ]
+ }
+ ],
- "resolution": "1K",
- "size": "auto",
- "output_format": "png"
+ "resolution": "2K",
+ "size": "auto"
}
}
체크리스트:
- 두 O3 모델 ID를 모두
kling-4.0-image로 바꿉니다. 이제 편집 모드는image_urls유무로 결정됩니다. elements를kling_elements로 바꾸고,frontal_image_url과reference_image_urls를 하나의element_input_urls배열로 합칩니다. 정면 시점이 첫 번째이며 URL은 총 2–4개입니다. 시점이 하나뿐인 O3 엘리먼트는 시점을 최소 하나 더 추가해야 합니다.output_format을 제거합니다. 스키마는 알 수 없는 필드를 거부합니다.1K를2K로 바꿉니다. O3의 기본값16:9에 의존했다면 새 기본값이auto이므로size를 명시하세요.- 비용 추정에 참조 추가 요금을 반영합니다.
- 8K와 세트에 대비해 클라이언트 타임아웃을 늘리거나 웹훅으로 전환합니다.
상태 폴링, files[].file_url 파싱, 웹훅 검증은 그대로입니다. 전체 요청 레퍼런스는 Kling Image 4.0 API 가이드에 있습니다.
Kling O1 Image는?
Kling O1 Image는 편집 전용(kling-o1-image-edit)이며 1K 또는 2K에서 이미지당 3.5 크레딧입니다. 위 표에서는 kling-o3-image-edit와 같이 취급하세요. 저렴한 참조 편집용이며 4K, 8K, 세트는 지원하지 않습니다.
자주 묻는 질문
Kling Image 4.0 API는 Kling O3 Image API를 그대로 대체할 수 있나요?
거의 그렇습니다. 엔드포인트, 인증, 폴링, 웹훅은 같습니다. 모델 ID를 바꾸고, elements를 kling_elements로 이름을 바꾸고, output_format을 제거하고, 1K 요청을 2K로 옮기면 됩니다.
Kling Image 4.0 API와 Kling O3 Image 중 어느 쪽이 더 저렴한가요? Kling O3 Image입니다. 1K 또는 2K에서 이미지당 3.5 크레딧, 4K에서 7 크레딧인 반면, Kling Image 4.0은 2K, 4K, 8K에서 13, 19, 32 크레딧이며 참조마다 1 크레딧이 추가됩니다.
Kling O3 Image는 8K나 이미지 세트를 지원하나요?
아니요. PoYo의 Kling O3 Image는 최대 4K이며 독립 이미지 1–9장을 반환합니다. 8K와 enable_sequential 세트는 Kling Image 4.0 API의 기능입니다.
Kling Image 4.0 API에서도 JPEG를 받을 수 있나요? API에서는 불가능하며 출력은 PNG입니다. 다운로드 후 변환하거나, JPEG와 WebP 작업은 Kling O3 Image에 남겨 두세요.
Kling Image 4.0 API를 쓰려면 새 API 키가 필요한가요?
아니요. 같은 PoYo 키로 kling-4.0-image, kling-4.0-long-image, kling-o3-image를 비롯한 모든 모델을 사용할 수 있습니다.