
Kling Image 4.0 API를 사용하면 PoYo 엔드포인트 하나로 Kling AI의 최신 이미지 모델을 호출할 수 있습니다. 2K, 4K, 8K 텍스트-이미지 생성, 편집, 이미지 세트에는 kling-4.0-image를, 웹페이지 전체나 이커머스 페이지 디자인에는 kling-4.0-long-image를 사용합니다. 이 글에서는 Kling Image 4.0이 무엇인지, 각 요청 필드의 역할, 제한 사항, 그리고 PoYo에서 호출 한 번에 드는 비용을 다룹니다.
Kling Image 4.0이란?
Kling Image 4.0은 Kuaishou의 AI 크리에이티브 플랫폼인 Kling AI가 만든 Kling 4.0 제품군의 이미지 모델이며, 2026년 11월 17일에 출시되었습니다. Kling은 출시 글에서 이 모델이 다음을 지원한다고 밝혔습니다.
- 네이티브 8K 이미지 생성. Kling이 이 모델에서 처음 도입한 기능입니다.
- 프롬프트 하나로 최대 10장의 이미지를 스타일과 내용의 일관성을 유지하며 생성.
- 이미지 한 장에 최대 2,000자의 텍스트를 영어, 중국어 간체, 중국어 번체, 일본어, 한국어, 스페인어, 포르투갈어로 렌더링.
- 이커머스 상품 상세 페이지와 웹 디자인용 롱폼 이미지 생성.
Kling은 또한 이 모델이 Kling Creative Studio에 공개되었고, 기업과 개발자는 API로 사용할 수 있다고 밝혔습니다. PoYo는 2026년 11월에 Kling Image 4.0 API를 추가했으며, 대기자 명단 없이 다른 모든 PoYo 모델에 쓰는 것과 같은 API 키로 사용할 수 있습니다.
PoYo의 Kling Image 4.0 API 모델 ID
| 모델 ID | 용도 | 출력 |
|---|---|---|
kling-4.0-image | 텍스트-이미지(image_urls 없음), 참조 이미지 1–10장을 쓰는 이미지-이미지, 엘리먼트, 이미지 세트 | 독립 이미지 1–9장 또는 2–10장 세트, 2K / 4K / 8K |
kling-4.0-long-image | skill: "webpage" 페이지 디자인, 상품 사진 1–3장으로 만드는 skill: "ecommerce" 상품 상세 페이지 | 세로로 긴 이미지 1장, 너비 1024 px(1K) 또는 2048 px(2K) |
두 ID 모두 같은 제출 엔드포인트, 같은 태스크 폴링, 같은 callback_url 웹훅을 사용합니다. 랜딩 페이지 슬러그는 kling-4-0-image이고, 요청에 쓰는 모델 ID는 점을 사용합니다(kling-4.0-image).
엔드포인트와 요청 구조
모든 Kling Image 4.0 API 요청은 비동기 태스크입니다.
Authorization: Bearer $POYO_API_KEY헤더와model,input으로 구성된 JSON 본문으로POST https://api.poyo.ai/api/generate/submit을 호출합니다.- 응답에서
data.task_id를 읽습니다. status가finished또는failed가 될 때까지GET https://api.poyo.ai/api/generate/status/{task_id}를 폴링합니다. 또는 최상위에callback_url을 넣어 태스크가 끝났을 때 POST를 받습니다.
문서의 구조를 그대로 따른 최소 4K 요청입니다.
{
"model": "kling-4.0-image",
"input": {
"prompt": "High fashion model wearing a dress made of living moss, standing in an abandoned greenhouse, shafts of light, editorial photography",
"size": "16:9",
"resolution": "4K"
}
}
완료된 태스크는 data.files에 이미지를 반환하며, 각 항목에는 file_url과 file_type: "image"가 있습니다. 이미지 세트는 순서대로 반환됩니다. HTTP 상태뿐 아니라 본문의 code 필드도 확인하세요. PoYo는 검증 오류를 HTTP 200과 code: 400으로 반환할 수 있습니다. cURL과 Python을 사용하는 단계별 설명은 Kling Image 4.0 API 가이드에 있습니다.
입력 필드와 제한
kling-4.0-image
| 필드 | 값 | 비고 |
|---|---|---|
prompt | 1–50,000자 | 필수. 입력은 @Image1, @Element1로 지칭 |
image_urls | URL 1–10개 | 지정하면 이미지-이미지 모드. 이미지당 최대 30 MB, 각 변 최소 300 px, 종횡비 0.4–2.5 |
kling_elements | 최대 7개 | 각각 {"element_input_urls": [...]} 형식, 2–4개 시점, 정면이 첫 번째. image_urls 필요. 이미지와 엘리먼트 합계 ≤ 10 |
size | auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 | 기본값 auto |
resolution | 2K, 4K, 8K | 기본값 2K. 8K는 1:1에서 8192×8192 |
enable_sequential | true / false | true면 일관된 이미지 세트를 반환 |
n | 1–9(독립) 또는 2–10(세트) | 기본값 각각 1과 4 |
스키마는 알 수 없는 필드를 거부하므로 output_format, seed, negative_prompt는 보내지 마세요. 출력은 PNG입니다.
kling-4.0-long-image
| 필드 | 값 | 비고 |
|---|---|---|
skill | webpage(기본값), ecommerce | 페이지 유형 선택 |
image_urls | 상품 사진 1–3장 | ecommerce에서 필수 |
style_image_url / subject_image_url | 각각 URL 1개 | webpage 전용. @StyleImage, @SubjectImage |
length | short, medium(기본값), long | ecommerce 전용. 섹션 약 2–5개, 6–10개, 11–18개 |
resolution | 1K(기본값), 2K | 너비 1024 또는 2048 px, 높이는 콘텐츠에 따라 결정 |
롱 이미지 요청은 한 번에 이미지 1장을 반환합니다.
PoYo의 Kling Image 4.0 API 가격
PoYo는 생성된 이미지 단위로 과금합니다(1 크레딧 = $0.005). 크레딧은 태스크가 성공했을 때만 차감됩니다.
| 요청 | 크레딧 | USD |
|---|---|---|
kling-4.0-image, 2K, 이미지당 | 13 | $0.065 |
kling-4.0-image, 4K, 이미지당 | 19 | $0.095 |
kling-4.0-image, 8K, 이미지당 | 32 | $0.16 |
image_urls 항목 및 kling_elements 엘리먼트 각각, 요청당 1회 | 1 | $0.005 |
| 롱 이미지, webpage, 1K / 2K | 110 / 120 | $0.55 / $0.60 |
| 롱 이미지, ecommerce short, 1K / 2K | 47 / 57 | $0.235 / $0.285 |
| 롱 이미지, ecommerce medium, 1K / 2K | 94 / 110 | $0.47 / $0.55 |
| 롱 이미지, ecommerce long, 1K / 2K | 157 / 173 | $0.785 / $0.865 |
롱 이미지, image_urls, style_image_url, subject_image_url의 이미지 각각 | 1 | $0.005 |
롱 이미지 가격표와 계산 예시는 가격 상세 분석에 있습니다.
출시 당일 측정 결과
PoYo 팀은 2026년 11월 19일 프로덕션 API에서 아래 요청을 실행했습니다. 시간은 폴링 클라이언트 기준으로 제출부터 결과까지 걸린 시간이므로 대략적인 값으로 보세요.
| 요청 | 출력 | 비용 | 시간 |
|---|---|---|---|
kling-4.0-image, 텍스트-이미지, 16:9, 8K, n: 1 | 10880×6144 PNG, 약 128 MB | 32 크레딧 | 약 3.8분 |
kling-4.0-image, 16:9, 2K, enable_sequential: true, n: 4 | 2720×1536 이미지 4장, 새벽부터 밤까지 같은 라이더, 바이크, 의상 유지 | 52 크레딧 | 약 4.9분 |
kling-4.0-long-image, skill: "webpage", 1K | 1024×4257 페이지 1장 | 110 크레딧 | 약 1.7–2.2분 |
같은 테스트에서 확인한 통합 시 참고 사항이 두 가지 있습니다. 첫째, 다운로드한 파일은 불투명한 이미지여도 알파 채널이 있는 PNG(RGBA)였으므로, 파이프라인이 RGB나 JPEG를 기대한다면 명시적으로 변환하세요. 둘째, 페이지 문구의 언어를 지정하지 않은 영어 웹페이지 프롬프트는 중국어 텍스트가 들어간 결과를 반환했고, "All text on the page is in English."를 추가하자 해결되었습니다. 두 가지 모두 8K 및 롱 이미지에서 더 자세히 다룹니다.
어떤 요청을 Kling Image 4.0 API로 보내야 할까?
- 4K를 넘는 해상도가 필요한 인쇄물, 빌보드, 크롭이 많은 작업: PoYo에서
8K등급을 제공하는 유일한 이미지 모델입니다. - 한 캐릭터나 제품이 여러 프레임에서 동일하게 유지되어야 하는 스토리보드, 제품 앵글, 슬라이드 덱:
enable_sequential을 사용하세요. - 이미 있는 제품이나 캐릭터를 새 장면에 배치: 장면은
image_urls로, 피사체는 다중 앵글 엘리먼트로 전달합니다. - 이미지 한 장으로 만드는 랜딩 페이지 목업과 이커머스 상세 페이지:
kling-4.0-long-image.
가장 낮은 가격으로 빠르게 1K–2K 초안을 만들려면 Kling O3 Image가 이미지당 더 저렴합니다. Kling Image 4.0 API vs Kling O3 Image를 참고하세요. 다른 벤더와 비교하려면 Kling Image 4.0 vs GPT Image 2.6 vs Seedream 5.5를 읽어 보세요.
자주 묻는 질문
Kling Image 4.0 API란 무엇인가요?
Kling AI의 Kling Image 4.0 모델에 접근하는 PoYo의 REST API로, 모델 ID는 kling-4.0-image(일반 이미지, 편집, 이미지 세트)와 kling-4.0-long-image(롱 웹페이지 및 이커머스 페이지)입니다. 둘 다 POST /api/generate/submit과 같은 API 키를 사용합니다.
Kling Image 4.0 API 비용은 얼마인가요? 2K는 이미지당 13 크레딧($0.065), 4K는 19 크레딧($0.095), 8K는 32 크레딧($0.16)이며, 참조 이미지나 엘리먼트마다 요청당 1회 1 크레딧($0.005)이 추가됩니다. 롱 이미지는 페이지당 47–173 크레딧입니다. 실패한 태스크는 과금되지 않습니다.
Kling Image 4.0 API는 이미지-이미지를 지원하나요?
네. kling-4.0-image에 image_urls로 URL 1–10개를 전달하고 프롬프트에서 @Image1, @Image2로 지칭하세요. 캐릭터나 오브젝트의 일관성을 위해 kling_elements를 최대 7개까지 추가할 수 있으며, 이미지와 엘리먼트 합계는 최대 10개입니다.
Kling Image 4.0 API 요청은 얼마나 걸리나요?
출시 당일 테스트에서 16:9 8K 이미지 1장은 약 3.8분, 2K 이미지 4장 세트는 약 4.9분, 1K 웹페이지는 약 2분이 걸렸습니다. 큰 작업은 요청을 열어 두지 말고 callback_url을 사용하세요.
Kling Image 4.0 API 문서는 어디에 있나요? 필드 레퍼런스는 Kling Image 4.0 문서와 롱 이미지 문서에 있습니다. 모델 페이지의 플레이그라운드에서는 설정에 맞는 JSON을 확인할 수 있습니다.