Image
Kling Image 4.0 Long Image
Kling Image 4.0 Long Image로 1K 또는 2K 세로형 이커머스 상품 상세페이지와 웹페이지 비주얼 디자인을 생성하고, 완성된 PNG URL을 조회하세요.
POST /v1/images/generations에 모델 ID kling-image-4-0-long-image를 포함한 JSON 요청을 전송하세요. 반환된 작업 ID를 저장한 뒤 세로형 PNG 한 장이 완성될 때까지 GET /v1/tasks/{id}를 조회하세요.
빠른 예시
이 요청은 텍스트 브리프만으로 1K 웹페이지 레이아웃을 생성합니다. API 키를 환경 변수 SEEDROUTER_API_KEY에 저장하세요.
curl https://api.seedrouter.ai/v1/images/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "kling-image-4-0-long-image",
"contents": [
{"type": "prompt", "text": "Design a tall landing page for a specialty coffee roastery with a hero banner, three single-origin bean cards, roasting notes, and store hours."}
],
"settings": {"skill": "webpage", "resolution": "1k"}
}'엔드포인트 및 헤더
POST https://api.seedrouter.ai/v1/images/generations 엔드포인트로 Content-Type: application/json과 Authorization: Bearer YOUR_API_KEY를 포함한 JSON을 전송합니다. 키는 서버에 보관합니다.
매개변수
| 필드 | 유형 | 값 및 기본값 |
|---|---|---|
model | 문자열, 필수 | kling-image-4-0-long-image |
contents | 배열, 필수 | prompt 항목 1개와 모드별 참조 이미지 항목들입니다. |
contents[].type | 문자열, 필수 | prompt, refer_image(ecommerce 전용, 1~3장 필수), style_refer_image(webpage 전용, 최대 1장) 또는 subject_refer_image(webpage 전용, 최대 1장)입니다. element는 지원하지 않습니다. |
contents[].text | 문자열 | prompt에 필수입니다. 영어 전용은 최대 166,000자, 비영어는 최대 71,000자입니다. 혼합 텍스트는 english / 166000 + non_english / 71000 <= 1 조건을 만족해야 합니다. |
contents[].url | 문자열 | 각 이미지 항목에 필수입니다. JPEG 또는 PNG 형식의 30 MB 이하 이미지에 접근 가능한 공개 HTTP(S) URL을 사용하세요. 가로와 세로는 각각 최소 300 px 이상이어야 하며, 가로세로 비율은 2:5~5:2여야 합니다. |
contents[].id | 문자열 | 요청 내 모든 이미지 항목에서 중복되지 않는 선택형 참조 ID입니다. 프롬프트에서 @id 형식으로 언급하세요. |
settings.skill | 문자열, 필수 | 상품 상세페이지에는 ecommerce, 웹페이지 디자인에는 webpage를 지정하세요. |
settings.length | 문자열 | short(약 2medium(기본값, 약 6long(약 11~18개 섹션)입니다. ecommerce에만 적용되며 webpage에서는 무시됩니다. |
settings.resolution | 문자열 | 1k(기본값, 가로 1024 px) 또는 2k(가로 2048 px)입니다. 높이는 콘텐츠에 따라 자동 조정됩니다. 4k는 지원하지 않습니다. |
options.watermark_info.enabled | 불리언 | 선택 사항입니다. false만 지원합니다. |
이커머스 상품 상세페이지
ecommerce 모드에서는 refer_image 항목 1~3장이 필수입니다. 프롬프트에서 각 사진을 id로 참조하세요.
{
"model": "kling-image-4-0-long-image",
"contents": [
{"type": "refer_image", "url": "https://example.com/kettle-front.png", "id": "front"},
{"type": "refer_image", "url": "https://example.com/kettle-spout.jpg", "id": "spout"},
{"type": "prompt", "text": "Build an ecommerce product detail page for the gooseneck kettle in @front with a close-up section highlighting @spout. Include hero visual, temperature control callouts, brewing scenes, and care notes."}
],
"settings": {"skill": "ecommerce", "length": "medium", "resolution": "2k"}
}스타일 및 피사체 참조를 활용한 웹페이지 디자인
webpage 모드에서는 선택 사항으로 style_refer_image(최대 1장)와 subject_refer_image(최대 1장) 항목을 받을 수 있습니다. webpage 모드에서는 settings.length를 생략하세요.
{
"model": "kling-image-4-0-long-image",
"contents": [
{"type": "style_refer_image", "url": "https://example.com/editorial-grid.png", "id": "layout"},
{"type": "subject_refer_image", "url": "https://example.com/watch.jpg", "id": "watch"},
{"type": "prompt", "text": "Design a watch launch webpage matching the typography and grid rhythm of @layout while showcasing @watch across the hero, movement breakdown, and spec table."}
],
"settings": {"skill": "webpage", "resolution": "2k"}
}롱 이미지 가져오기
POST 응답의 id를 TASK_ID에 복사한 뒤 상태가 completed 또는 failed가 될 때까지 조회하세요. 롱 이미지 작업은 보통 몇 분이 걸리며, 특히 long + 2k 레이아웃은 더 오래 걸릴 수 있습니다.
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"완료되면 output.data[0].url을 읽으세요. 요청 한 건당 완성된 세로형 PNG 한 장이 생성됩니다. 2k에서는 긴 페이지가 50 MB를 넘을 수 있으므로 다운로드 타임아웃과 뷰어 배율을 넉넉하게 계획하세요. 자세한 내용은 작업 참조 문서와 오류 목록을 확인하세요.
요금
완료된 요청마다 출력 등급 요금 1건(ecommerce는 resolution × length 기준, webpage는 resolution 기준)과 첫 번째 이미지를 포함한 입력 이미지당 참조 이미지 요금 1건이 부과됩니다. 요청이 실패하면 요금이 부과되지 않습니다. 현재 요금을 확인하세요.
오류 및 팁
잘못된 요청은 과금 전에 HTTP 400을 반환합니다. 자주 발생하는 검증 오류는 settings.skill 누락, refer_image URL 1~3장 없이 ecommerce 전송, webpage 모드에 refer_image 혼용, 4k 요청, 참조 ID 중복 등입니다.
프롬프트에 히어로 배너부터 사양표나 푸터까지 정확한 섹션 순서를 명시하고, 레이아웃의 정확도를 유지할 수 있도록 검증된 제품 정보만 포함하세요. Kling Image 4.0 Long Image 플레이그라운드와 OpenAPI 스키마를 참조하세요.
