
숨겨진 수수료 없는 투명한 요금제. 사용한 만큼만 지불하세요.
APIMart의 Kling Image 4.0 Long Image API는 모델 ID kling-v4-long-image를 사용합니다. ecommerce를 선택하면 상품 이미지 1~3장으로 상품 상세 페이지를 만들고, webpage를 선택하면 스타일 참조와 피사체 참조를 선택적으로 더해 웹 페이지를 디자인합니다. 1K 또는 2K를 고르면 모델이 콘텐츠에 따라 세로 길이가 정해지는 긴 PNG 한 장을 반환합니다. 작업은 비동기로 실행되며, 각 요청은 페이지 요금 구간에 참조 이미지 요금을 더해 청구됩니다.
kling-v4-long-image 작업을 제출한 뒤 작업 ID로 결과를 조회합니다. 예제는 이커머스 상품 상세 페이지와 웹 페이지 디자인을 만듭니다.
APIMart API 키를 APIMART_API_KEY로 저장하세요. 예제는 작업 제출과 조회 시 Authorization: Bearer <key>를 보냅니다.
model을 kling-v4-long-image로 설정하고 skill, 프롬프트와 함께 POST /v1/images/generations로 요청을 보내세요. ecommerce에는 image_urls를, webpage에는 image_with_roles를 추가합니다. 작업 ID는 data[0].task_id에서 읽습니다.
GET /v1/tasks/{task_id}를 호출하세요. 완료된 작업은 data.result.images[0].url[0]을, 실패한 작업은 data.error.message를 읽습니다.
모든 파라미터와 오류 코드는 Kling Image 4.0 Long Image API 문서에서 확인하세요.
curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-v4-long-image",
"prompt": "@Image1의 향수로 이커머스 상품 상세 페이지를 만들어 주세요.",
"skill": "ecommerce",
"length": "medium",
"resolution": "1K",
"image_urls": [
"https://example.com/perfume.png"
]
}'import os
import time
import requests
API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}
# 1. Submit the generation task
payload = {
"model": "kling-v4-long-image",
"prompt": "@Image1의 향수로 이커머스 상품 상세 페이지를 만들어 주세요.",
"skill": "ecommerce",
"length": "medium",
"resolution": "1K",
"image_urls": [
"https://example.com/perfume.png"
]
}
resp = requests.post(f"{API_BASE}/v1/images/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]
# 2. Poll the task until it finishes
for _ in range(200):
task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
task_resp.raise_for_status()
task = task_resp.json()["data"]
if task["status"] == "completed":
print(task["result"]["images"][0]["url"][0])
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
time.sleep(3)
else:
raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-v4-long-image",
"prompt": "@Image1의 스타일로 스페셜티 커피 브랜드의 랜딩 페이지를 디자인하고, @Image2의 커피 원두 봉투를 메인으로 보여 주세요.",
"skill": "webpage",
"resolution": "2K",
"image_with_roles": [
{
"url": "https://example.com/brand-style.png",
"role": "style"
},
{
"url": "https://example.com/coffee-bag.png",
"role": "subject"
}
]
}'TASK_ID="task_xxx" # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $APIMART_API_KEY"| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | 필수 | 기본값: kling-v4-long-image | Kling Image 4.0 Long Image의 모델 ID입니다. |
prompt | string | 필수 | 기본값: — | 페이지 설명입니다. 영어 최대 166,000자 또는 중국어 최대 71,000자이며, 혼합된 텍스트는 비율에 따라 계산됩니다. 참조 이미지는 @Image1, @Image2 등으로 지정합니다. |
skill | string | 필수 | 기본값: — | ecommerce(상품 상세 페이지) 또는 webpage(웹 페이지 디자인)이며 대소문자를 구분하지 않습니다. |
length | string | 선택 | 기본값: medium | ecommerce 전용: short, medium 또는 long(약 2~5개, 6~10개 또는 11~18개 콘텐츠 섹션). webpage에서는 보내지 마세요. |
resolution | string | 선택 | 기본값: 1K | 1K(가로 1024 px) 또는 2K(가로 2048 px)이며 대소문자를 구분하지 않습니다. 세로 길이는 콘텐츠에 따라 정해집니다. |
image_urls | string[] | 선택 | 기본값: — | ecommerce에서 필수: 공개 URL로 지정하는 상품 이미지 1~3장. JPG, JPEG 또는 PNG이며 장당 30 MB 이하, 가로·세로 각각 300 px 이상, 가로세로 비율은 2:5~5:2 사이여야 합니다. webpage에서는 사용할 수 없습니다. |
image_with_roles | object[] | 선택 | 기본값: — | webpage 전용, 선택 사항: url과 role로 구성된 항목이며, 스타일 이미지(시각 스타일과 레이아웃 스타일)와 피사체 이미지(유지할 피사체)를 각각 최대 1장까지 지정할 수 있습니다. 이미지 요건은 image_urls와 같습니다. ecommerce에서는 사용할 수 없습니다. |
APIMart에서 kling-v4-long-image로 할 수 있는 것: 상품 상세 페이지부터 웹 레이아웃 전체까지.
skill을 ecommerce로 설정하고 상품 이미지를 1~3장 추가하세요. 모델이 상품을 중심으로 상품 상세 페이지 전체를 구성해 긴 이미지 한 장으로 반환합니다.
skill을 webpage로 설정하면 프롬프트를 바탕으로 웹 페이지를 디자인합니다. 스타일 참조와 피사체 참조는 둘 다 넣어도, 하나만 넣어도, 넣지 않아도 됩니다.
ecommerce에서는 short(약 2~5개 콘텐츠 섹션), medium(약 6~10개, 기본값), long(약 11~18개) 중에서 선택할 수 있습니다.
1K 출력은 가로 1024 px, 2K는 가로 2048 px입니다. 세로 길이는 콘텐츠에 따라 정해지며, 요청마다 PNG 한 장이 반환됩니다.
JPG 또는 PNG 이미지를 사용할 수 있으며, 장당 30 MB 이하, 가로·세로 각각 300 px 이상, 가로세로 비율은 2:5~5:2 사이여야 합니다. 프롬프트에서는 @Image1, @Image2 등으로 지정합니다.
프롬프트에는 영어 최대 166,000자 또는 중국어 최대 71,000자를 입력할 수 있어, 페이지의 모든 섹션을 자세히 설명할 수 있습니다.
POST /v1/images/generations로 제출한 뒤 GET /v1/tasks/{task_id}로 폴링하세요. 긴 이미지의 URL은 data.result.images[0].url[0]에 있습니다.
각 요청은 페이지 요금 구간에 참조 이미지 장당 요금을 더해 청구됩니다. 400 오류로 거부된 요청은 청구되지 않고 실패한 작업은 전액 환불되며, API 키 하나로 APIMart의 모든 모델을 사용할 수 있습니다.
팀이 이커머스와 웹 작업에서 kling-v4-long-image를 활용하는 대표적인 방법입니다.
상품 사진을 업로드하면 그 상품을 중심으로 구성된 상세 페이지 전체를 받을 수 있습니다. 예를 들어 Kling 공식 예시에 나온 향수 상품 상세 페이지 같은 결과입니다.
랜딩 페이지를 긴 이미지 한 장으로 구성해, 개발에 들어가기 전에 시각적 방향과 섹션 순서를 검토하세요.
스타일 참조를 추가하면 브랜드의 룩을 웹 페이지 전체에 이어서 적용하고, 하나로 이어진 디자인으로 보여 줍니다.
신제품 출시와 세일 이벤트용 긴 프로모션 페이지 초안을 만들고, 헤드라인과 셀링 포인트, 혜택을 이미지 한 장에 담으세요.
같은 상품이나 사이트에 대해 페이지 길이나 프롬프트를 바꿔 보고, 전체 페이지 디자인을 나란히 비교하세요.
다른 모델에 쓰는 것과 같은 APIMart API 키로 백엔드에서 kling-v4-long-image를 호출하고, 반환된 이미지를 저장하세요.
API 키를 만들고 페이지 유형을 고른 뒤, 이 페이지나 코드에서 작업을 실행하세요.
APIMart 콘솔에서 API 키를 만드세요. 같은 키로 APIMart의 모든 모델을 사용할 수 있으며, 요청에는 Authorization: Bearer <key> 형식으로 보냅니다.
ecommerce를 선택해 상품 이미지를 1~3장 추가하거나, webpage를 선택하고 필요하면 스타일 참조와 피사체 참조를 추가하세요. 그런 다음 페이지를 설명하고 페이지 길이와 1K 또는 2K를 선택하세요.
RUN을 클릭하면 예상 비용을 확인하고 작업을 시작할 수 있습니다. 같은 JSON을 POST /v1/images/generations로 보내도 됩니다. 작업이 완료되면 결과가 기록에 표시됩니다.
kling-v4-long-image 파라미터, 가격, API 키, 명칭에 대한 답변입니다.
Kling Image 4.0 Long Image는 Kling Image 4.0의 긴 이미지 생성 기능입니다. Kling Image 4.0은 콰이쇼우(Kuaishou)의 AI 크리에이티브 플랫폼인 Kling AI의 이미지 모델입니다. 이커머스 상품 상세 페이지나 웹 페이지 디자인을 전체 레이아웃이 담긴 긴 이미지 한 장으로 생성합니다. APIMart에서는 kling-v4-long-image로 호출합니다.
Kling AI는 2026년 11월 17일에 Kling Image 4.0을 출시했으며, 이커머스 상품 상세 페이지와 웹 디자인용 긴 이미지 생성도 이때 함께 공개되었습니다. APIMart에서는 이 페이지와 API에서 kling-v4-long-image 모델 ID로 사용할 수 있습니다.
model 필드에 kling-v4-long-image를 입력하세요. 이 페이지 주소는 /model/kling-image-4-0-long-image이지만, kling-image-4-0-long-image는 API 요청에 사용할 수 있는 모델 ID가 아닙니다.
각 요청은 해당 요금 구간의 가격으로 청구됩니다. ecommerce는 해상도와 페이지 길이(1K와 2K 각각 short, medium, long)로, webpage는 해상도(1K 또는 2K)로 구간이 나뉩니다. 참조 이미지는 상품 이미지, 스타일 이미지, 피사체 이미지 모두 장마다 요청당 한 번 청구됩니다. 현재 가격은 이 페이지의 가격표에서 확인할 수 있습니다.
APIMart 콘솔에서 API 키를 만드세요. APIMart API 키 하나로 모든 모델을 사용할 수 있으므로 Kling Image 4.0 Long Image용 키를 따로 받을 필요가 없습니다.
네. 로그인한 뒤 이 페이지 상단의 워크스페이스나 대시보드의 Playground를 사용하세요. RUN 버튼은 시작 전에 예상 비용을 보여 주며, JSON 보기에서는 코드에 그대로 쓸 수 있는 정확한 요청을 확인할 수 있습니다.
네. ecommerce는 image_urls에 상품 이미지 1~3장이 필요합니다. webpage는 image_with_roles에 스타일 이미지와 피사체 이미지를 각각 최대 1장까지 넣을 수 있으며, 둘 다 선택 사항입니다. 각 이미지는 30 MB 이하의 JPG, JPEG 또는 PNG여야 하며, 가로·세로 각각 300 px 이상, 가로세로 비율은 2:5~5:2 사이이고, 공개 URL로 제공되어야 합니다. 워크스페이스에서는 로컬 파일을 대신 업로드해 줍니다. 링크가 403·404·410을 반환하거나 이미지가 이 요건에 맞지 않으면 요청이 즉시 400 오류로 거부되며, 작업이 생성되지 않고 비용도 청구되지 않습니다. 원본 서버 시간 초과 등 다른 이유로 이미지를 불러오지 못하면 작업이 실패하고 전액 환불됩니다.
가로 폭은 resolution으로 정해지며, 1K(기본값)는 가로 1024 px, 2K는 가로 2048 px입니다. 세로 길이는 콘텐츠에 따라 정해지고, 요청마다 긴 PNG 한 장이 반환됩니다. size, aspect_ratio, width, height, mask_url은 지원하지 않으며, n은 1만 가능하고 워터마크는 사용할 수 없습니다.
상품 상세 페이지에는 skill ecommerce를 사용합니다. 상품 이미지를 1~3장 추가하고 length를 short, medium(기본값) 또는 long 중에서 고르세요. 웹 페이지 디자인에는 skill webpage를 사용합니다. length는 사용하지 않으며, 시각 스타일과 레이아웃 스타일을 위한 스타일 참조와 유지할 피사체를 위한 피사체 참조를 추가할 수 있습니다. 프롬프트에서 ecommerce 이미지는 image_urls 순서를 따르고, webpage에서는 스타일 이미지가 @Image1이며 피사체 이미지가 그다음입니다.
영어 최대 166,000자 또는 중국어 최대 71,000자이며, 혼합된 텍스트는 비율에 따라 계산됩니다.
아니요. 잘못된 요청은 작업을 만들지 않고 비용도 청구하지 않은 채 즉시 400 오류를 반환합니다. 접수된 뒤 작업이 실패하면 비용이 전액 환불됩니다.
생성된 이미지는 72시간 동안 보관됩니다. 보관하려는 이미지는 그 전에 다운로드하세요.
APIMart에서는 서로 다른 두 모델 ID입니다. kling-v4-image는 단일 이미지나 소수의 시리즈 이미지를 생성하는 범용 Kling Image 4.0 모델입니다. kling-v4-long-image는 상품 상세 페이지나 웹 디자인용으로 긴 이미지 한 장을 반환합니다. Kling 4.0과 Kling 4.0 Flash는 또 다른 모델로, Kling의 영상 모델입니다.
네. Kling Image V4 Long Image는 Kling의 V4 버전 표기를 사용한 이름입니다. Kling V4 Long Image, Kling 4.0 Long Image, Kling Image 4 Long Image 또는 Kling Image 4.0 Long-Image라는 표기도 볼 수 있습니다. 모두 Kling Image 4.0의 긴 이미지 생성을 가리키며, APIMart에서는 kling-v4-long-image로 호출합니다.
같은 카테고리의 다른 모델을 탐색하세요.

Mai Image 2.7 Flash
MAI-Image-2.7-Flash is the faster, more cost-efficient version of Microsoft’s MAI-Image-2.7 image editing model, built for quick responses and high-volume image workflows.

Mai Image 2.7
Text to Image,Image to Image

Kling V4 Image
Kling Image 4.0 generates 2K or 4K images from a text prompt or up to 10 reference images, either as 1 to 9 independent images or as a related series of 2 to 4 images.

MiniMax H3 Image
Built for image quality and prompt adherence. It handles text-to-image, reference-based generation and image editing. MiniMax says it can generate a 4K (4096 × 4096) image in under 10 seconds and work with up to 16 reference images. In Chinese launch coverage, MiniMax puts its speed at about 1.5 to 2 times that of mainstream tools.