소개
제품 사진을 업로드하고 판매 포인트를 나열하면 완성된 상세 페이지를 받습니다. 페이지 길이와 스토어에 맞는 해상도를 선택합니다.
| 항목 | 값 |
|---|---|
| 입력 | 이미지 |
| 출력 | 이미지 |
| 발행사 | Kling |
| 출시일 | 2026년 11월 17일 |
| 페이지 작업 | 웹페이지 디자인; 전자상거래 상품 상세 페이지 |
| 프롬프트 크기 | 두 작업 모두 1~71,000자 |
| 해상도 단계 | 1k(기본값), 2k |
| 상품 상세 페이지 길이 | short, medium(기본값), long |
| 웹페이지 참고 이미지 수 | 0~3장 |
| 필수 상품 사진 수 | 1~3장 |
| 입력 이미지 요건 | JPG 또는 PNG; 최대 30 MB; 각 변 300 px 이상; 비율 2:5~5:2 |
| 기록된 웹페이지 결과 | 2k에서 2048 x 16469 PNG |
| 기록된 상품 페이지 결과 | short 길이와 1k에서 1024 x 5021 PNG |
핵심 기능 및 하이라이트
도예 요청서가 전체 페이지로 이어졌습니다
Tideline Ceramics 요청은 대표 제목, 그릇, 공방 이야기, 푸터를 지정했습니다. 반환된 2k PNG는 2048 x 16469 크기이며 해당 섹션들을 포함했습니다. 이처럼 긴 페이지를 재사용하기 전에 작은 본문을 확인합니다.
장미 사진을 중심으로 한 짧은 레이아웃
보존 장미 요청은 제공된 상품 이미지, short 페이지 길이, 1k 해상도를 사용했습니다. 그 사진을 중심으로 상품 상세 페이지를 구성한 1024 x 5021 PNG 한 장이 반환되었습니다.
각 섹션에 역할과 문구를 지정합니다
두 엔드포인트 모두 최대 71,000자 프롬프트를 지원합니다. 읽는 순서, 제공 문구, 참고 이미지의 역할을 구체적으로 작성합니다. 웹사이트 참고 이미지는 선택 사항이며 상품 상세 페이지에는 상품 사진 한 장에서 세 장이 필요합니다.
길이와 해상도를 별도로 선택합니다
두 작업 모두 1k와 2k를 제공하며 기본값은 1k입니다. 상품 상세 페이지에는 short, medium, long 길이 선택기가 추가됩니다. 이 설정들이 페이지 요금에 영향을 주며, 입력 이미지마다 소액 입력 요금도 부과됩니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수 항목이며 71,000자까지 입력할 수 있습니다. 제품 정보, 판매 포인트, 모듈 순서를 적고 사진은 @ |
image_urls | 예 | 제품 사진 1 |
page_length | 아니요 | 페이지 길이로 short, medium, long 중에서 선택합니다. 기본값은 medium이며 페이지가 길수록 요금이 올라갑니다. |
resolution | 아니요 | 페이지 등급으로 1k 또는 2k를 선택하며 기본값은 1k입니다. 모든 길이에서 2k의 요금이 더 높습니다. |
요금
완성된 페이지마다 길이와 해상도에 따른 요금이 청구되며, 제품 사진마다 소액의 입력 요금이 추가됩니다.
| 해상도 | Page length: short | Page length: medium | Page length: long |
|---|---|---|---|
| $0.235 / 장 | $0.47 / 장 | $0.784 / 장 |
| $0.282 / 장 | $0.549 / 장 | $0.862 / 장 |
활용 사례
도예 공방 웹사이트 콘셉트
도예 사업을 위한 대표 영역, 주요 그릇, 공방 이야기, 영업시간을 구성합니다. Tideline Ceramics 실행에서는 이 섹션들을 담은 2048 x 16469 PNG 한 장이 반환되었으며, 작은 본문은 재사용 전에 검토해야 합니다.
선물용 상품 상세 레이아웃
상품 사진을 제공하고 대표 영역, 판매 포인트, 관리 방법, 선물 메시지 패널을 요청합니다. 보존 장미의 짧은 페이지 실행에서는 제공한 사진을 중심으로 구성된 1024 x 5021 PNG 한 장이 반환되었습니다.
디자인 전달을 위한 브랜드 방향
선택적 웹사이트 참고 이미지로 색상이나 대상을 전달한 다음 프롬프트에 독자와 섹션 순서를 제시합니다. 사이트를 구축하기 전에 팀과 결과 페이지 이미지를 검토합니다.
페이지 길이에 맞춘 상품 소개 요청서
판매할 상품의 검증된 정보를 모듈로 나누고 short, medium, long을 선택합니다. 선택한 길이에 텍스트 분량을 맞추고 생성 페이지에서 누락되거나 변경된 사실이 있는지 확인합니다.
프롬프트 가이드 및 실전 팁
요청서에 맞는 엔드포인트를 선택합니다
텍스트로 설명한 사이트 시안에는 웹페이지 디자인을 선택하고 필요한 경우 참고 이미지를 추가합니다. 상품 사진과 검증된 판매 포인트가 있으면 상품 상세 엔드포인트를 사용합니다.
위에서 아래로 읽는 흐름을 작성합니다
모듈을 읽는 순서대로 배치하고 각 모듈의 제목, 본문, 버튼 문구를 인용합니다. 번호가 매겨진 참고 이미지마다 어떤 내용을 제공하며 어떻게 사용할지도 설명합니다.
페이지 설정을 선택합니다
두 엔드포인트 모두 1k 또는 2k 해상도를 선택합니다. 상품 상세 페이지는 short, medium, long 중 길이도 선택하며 기본값은 medium입니다.
다운로드한 페이지를 검토합니다
읽기 적합한 크기로 이미지를 표시하고 문구와 상품 관련 주장을 요청서와 대조합니다. 디자이너에게 전달하거나 상품 게시용 이미지를 준비하기 전에 모듈 사이의 흐름도 확인합니다.
제공 사진을 중심으로 상품 이야기를 구성합니다
이 엔드포인트는 상품 사진과 판매 요청서를 받아 연속된 상세 페이지 이미지를 구성합니다. 구매자가 상품을 보고 제공된 판매 포인트를 이해하며 모듈 순서에 따라 정보를 읽어야 할 때 사용합니다. 사진과 함께 상품 정보를 준비하고 페이지에서 무엇을 전달할지 요청서로 정합니다.
웹페이지 디자인과 달리 이 작업은 상품 사진을 필수로 요구하며 페이지 길이 설정을 제공합니다. 결과는 검토하거나 상품 게시용 이미지로 준비하는 평면 시안입니다. 편집 가능한 쇼핑몰이나 개별 모듈 파일은 제공하지 않습니다.
상품 입력과 페이지 설정
길이와 해상도를 고르기 전에 이미지와 검증된 문구를 준비합니다. 두 설정 모두 페이지 요금에 영향을 주며 업로드한 상품 사진에는 입력 요금이 추가됩니다.
| 매개변수 | 요건 | 목적 |
|---|---|---|
prompt | 필수 문자열, 1~71,000자 | 상품 정보, 판매 포인트, 모듈 순서를 제공하고 @image_1, @image_2로 사진을 참조합니다. |
image_urls | 필수 배열, 사진 1~3장 | 최대 30 MB, 각 변 300 px 이상, 비율 2:5~5:2인 JPG 또는 PNG를 사용합니다. |
page_length | 선택 사항: short, medium, long; 기본값 medium | 상세 페이지 길이를 선택합니다. |
resolution | 선택 사항: 1k 또는 2k; 기본값 1k | 길이와 별개로 출력 단계를 선택합니다. |
보여줄 상품 정보량에 맞춰 페이지 길이를 설정합니다. 해상도는 따로 선택하고 쇼핑몰에서의 예정 위치를 고려하여 결과 이미지를 검토합니다.
사진이 전달하는 정보를 기준으로 선택합니다
상품을 명확하게 보여주고 번호가 있는 이미지마다 전체 외관이나 세부 확대 등 무엇을 제공하는지 설명합니다. 사진에서 보이는 정보와 텍스트로 제공한 사양을 구분합니다. 상품 소개용 시점과 세부 모듈을 보완할 시점을 설명하여 사진마다 페이지의 특정 부분에 연결합니다.
판매 요청서를 구성합니다
상품의 정체성과 검증된 정보부터 시작합니다. 그다음 구매자에게 보여줄 순서대로 대표 영역, 제공 판매 포인트, 보조 상품 세부 정보, 마무리 패널을 나열합니다. 확인된 문구가 있으면 관리 방법을 포함합니다. 빈 섹션을 채우려고 모델에 치수, 소재, 주장을 만들어 달라고 요청하지 않습니다.
확인 가능한 문구를 작성합니다
제목과 정보 블록별 문구를 인용하고 옆에 들어갈 섹션을 표시합니다. 사실이 확인되지 않으면 요청 문구에서 제외합니다. 포괄적인 형용사 목록은 검토 근거가 부족하지만 상품 특성에 관한 구체적인 문장은 반환 이미지와 직접 비교합니다. 요청서에 사실, 시각적 방향, 모듈 순서를 명확히 작성합니다.
콘텐츠 분량을 길이에 맞춥니다
short, medium, long을 선택하고 그 범위에 맞는 요청서를 작성합니다. 짧은 페이지는 간결한 상품 소개에 집중하고, 긴 요청서는 추가로 제공된 정보에 공간을 배정합니다. 각 모듈에 다른 목적을 부여하고 프롬프트 제출 전에 반복된 판매 포인트를 제거합니다. 해상도 변경은 별개의 결정이며 과도한 문구를 줄이는 작업을 대신하지 않습니다.
보존 장미 실행의 관찰 결과
2026년 11월 18일 요청은 장미 사진 한 장과 함께 호박색과 아이보리 배색의 대표 사진, 판매 포인트 세 가지, 관리 방법, 마무리 선물 메시지 패널을 요구했습니다. 설정은 short 길이와 1k였습니다. 요청서는 상품 사진을 소개에서 관리와 선물로 이어지는 순서에 연결했습니다.
응답에는 제공한 장미 사진을 중심으로 짧은 상품 상세 페이지를 구성한 1024 x 5021 PNG 한 장이 포함되었습니다. 구매자용으로 준비하기 전에 전체 흐름에서 상품 외관을 확인하고 판매 포인트, 관리 문구, 마무리 메시지를 제공 원고와 대조합니다.
요금과 게시 전 확인
선택한 길이와 해상도에 대해 여기에 표시된 현재 요금을 확인합니다. 완성된 상품 상세 페이지는 두 선택에 따라 청구하며 상품 사진마다 소액 입력 요금이 추가됩니다. 필수 상품 이미지를 무료 첨부로 보지 않고 제공한 모든 사진을 입력 요금 계산에 포함합니다.
쇼핑몰용 이미지를 준비하기 전에 묘사된 상품을 제공 사진과 비교하고 모든 주장, 수치, 관리 방법을 상품 정보표와 대조합니다. 예정된 표시 크기에서 간격과 읽는 순서도 검토합니다. 결과는 한 장의 페이지 이미지이므로 이후 레이아웃이나 문구 수정에는 이미지 편집 또는 디자인 작업 흐름이 필요합니다.
다른 제품군이 결과물에 맞는 경우
Kling은 표준 이미지 작업 흐름을 개별 시각 자료용으로, 시리즈 작업 흐름을 서로 조화를 이루는 별도 이미지용으로 설명합니다. 개별 상품 그래픽에는 Kling Image 4.0을, 별도 이미지 모음에는 Kling Image 4.0 Set을 비교합니다. 제공 사진을 기반으로 연속된 상품 상세 페이지가 필요하면 이 엔드포인트를 사용합니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "kling/image-4.0-long/edit",
"input": {
"image_urls": [
"https://example.com/reference.png"
],
"page_length": "medium",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.













