Claude Opus 5.5을(를) SeedRouter에서 사용할 수 있습니다

Kling Image 4.0 Long Image 튜토리얼

Kling Image 4.0 Long Image로 2K 웹페이지 레이아웃과 이커머스 상세페이지를 만듭니다. 실제 롱 PNG 실행 2건, curl 요청, 상태 조회 및 실시간 요금을 확인합니다.

Markdown으로 읽기

일반 이미지 모델은 한 번에 한 프레임씩만 생성합니다. 상품 상세페이지나 전체 출시 웹사이트를 요청하면 서로 연결되지 않은 배너 예닐곱 장을 따로 뽑은 뒤 레이아웃 편집기에서 들쭉날쭉한 여백, 자꾸 바뀌는 폰트, 어긋난 제품 비율을 수동으로 맞춰야 합니다. Kling Image 4.0 Long Image는 방식이 다릅니다. API 요청 한 번으로 위에서 아래까지 하나의 구조로 이어지는 세로형 PNG 한 장을 반환하며, 가로는 1K(1024 px) 또는 2K(2048 px)로 고정되고 세로는 브리프에 담은 섹션 구성에 따라 결정됩니다.

2026년 11월 19일에 SeedRouter의 /v1/images/generations 엔드포인트로 2K 작업 두 건을 실행해 실제 제작 브리프 기준으로 두 모드를 모두 테스트했습니다. 첫 번째 실행은 텍스트만 사용한 webpage 모드로, 가상의 스튜디오 헤드폰 브랜드 출시 페이지 2048 × 16385 px 결과물(17 MB, 169초)을 얻었습니다. 두 번째 실행은 ecommerce 모드 medium 길이에 기존 주얼리 참조 사진 두 장을 넣어 2048 × 19533 px 상품 상세페이지(25 MB, 261초)를 생성했습니다. 아래에서 전체 스크롤 결과물을 살펴보고, Kling Image 4.0 Long Image 플레이그라운드에서 두 브리프를 직접 시험해 본 뒤, 하단 실시간 요금표에서 정확한 등급별 단가를 확인해 보세요.

프롬프트를 쓰기 전에 ecommerce와 webpage부터 선택하세요

settings.skill은 필수 필드이며, 시각적 레이아웃 문법뿐 아니라 API가 허용하는 매개변수까지 결정합니다. 두 모드는 단순한 스타일 프리셋이 아니라 별도의 요청 규격으로 다뤄야 합니다.

실제 제품 사진이 이미 있고 자사몰이나 오픈마켓용 세로형 상품 상세페이지(PDP)가 필요하다면 ecommerce를 선택하세요. ecommerce 모드에서는 contents에 refer_image 항목을 1~3장 반드시 포함해야 하며, 세로 섹션 분량은 settings.length(short, medium, long, 기본값 medium)로 조절합니다. 제품 참조가 0장인 요청은 과금 전에 거부됩니다.

브랜드 랜딩페이지, 출시 사이트 또는 에디토리얼 웹 레이아웃을 구상한다면 webpage를 선택하세요. webpage 모드에서는 참조 이미지가 선택 사항입니다. 텍스트만으로 실행하거나 색감과 레이아웃 리듬을 잡아 주는 style_refer_image 최대 1장, 중심 오브젝트를 고정해 주는 subject_refer_image 최대 1장을 함께 넘길 수 있습니다. webpage 모드에서는 refer_image나 settings.length를 보내지 마세요. 두 필드는 ecommerce 전용이므로 섞어 쓰면 검증 오류가 발생합니다.

설정 또는 입력ecommerce 모드webpage 모드
settings.skill"ecommerce" (필수)"webpage" (필수)
settings.length"short", "medium" (기본값) 또는 "long"완전히 생략
settings.resolution"1k" (가로 1024 px) 또는 "2k" (가로 2048 px)"1k" (가로 1024 px) 또는 "2k" (가로 2048 px)
refer_image 항목필수: 공개 JPEG/PNG URL 1~3개허용 안 됨
style_refer_image / subject_refer_image허용 안 됨선택: 각 최대 1개

두 모드 모두 4k, 배치 수량(n), 화면비 지정은 지원하지 않습니다. 성공한 작업은 항상 output.data[0].url로 세로형 PNG URL 하나를 반환합니다.

실행 1: 텍스트 전용 2K 웹페이지 레이아웃 (2048 × 16385)

2048×16385 Solstice Audio S-01 Reference Planar 웹페이지의 4단 전체 보기

위 이미지는 webpage 2K 실행 결과물을 세로 4등분해 나란히 배치한 모습입니다. 브리프에서는 오픈백 평판형 헤드폰 S-01 Reference Planar를 소개하는 다크 옵시디언 톤의 스위스 인더스트리얼 출시 페이지를 요청했습니다. 구성은 미니멀 상단 바, 3/4 각도 히어로 사진, 3단 음향 특장점 섹션, CNC 가공 절개도, 실제 전기 사양 수치가 담긴 기술 사양표, 차분한 푸터 순서였습니다.

단일 연속 생성에서 어떤 요소들이 끝까지 유지됐는지 자세히 살펴보세요. 세로 16,385 픽셀에 걸쳐 짙은 차콜 배경, 세리프 디스플레이 제목, 브러시드 알루미늄 제품 형태가 상단 내비게이션 바부터 5가지 컬러웨이 스트립과 사양표까지 일관되게 이어졌습니다. 요청한 전기 사양 수치(106 mm Iso-Planar, 32 Ohms, 98 dB/mW, 8 Hz–52 kHz, 410 g)도 모두 읽기 좋게 렌더링됐습니다. 원본 PNG를 100% 배율로 검수하면서 발견한 작은 차이도 짚어 둘 만합니다. 프롬프트에서는 사양표 뒤에 밝은 앨러배스터 밴드를 요청했지만, 모델은 사양표를 어두운 슬레이트 위에 두고 대신 그 아래 뉴스레터 가입 영역에 밝은 회색 밴드를 배치했습니다. 개발 핸드오프에서 특정 섹션의 배경 전환이 반드시 지켜져야 한다면 결과물을 비주얼 아트 디렉션 시안으로 활용하고, 생성된 사진 소재를 바탕으로 해당 HTML 밴드를 자르거나 재구성하는 편이 안전합니다.

좋은 webpage 브리프는 정지 사진 프롬프트보다 와이어프레임 개요서에 가깝습니다. 맨 앞에 전역 디자인 토큰(배경 hex 코드, 표면 재질, 포인트 컬러, 그리드 규칙)을 적고, 그다음 위에서 아래 순서대로 각 밴드에 번호를 매겨 헤드라인과 핵심 수치에 들어갈 구체적인 영문 카피를 명시하세요. 제목을 모호하게 비워 두면 임의의 더미 문구가 들어가기 쉽습니다.

curl --fail-with-body -sS 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 vertical flagship product launch webpage for SOLSTICE AUDIO introducing the S-01 Reference Planar open-back studio headphones. Visual language: Swiss minimalist editorial web design, matte obsidian slate (#0E1014), brushed titanium silver surfaces, amber-gold accents, sharp typography. (1) Minimal top bar with wordmark and Reserve button. (2) Hero with headline Silence, Machined. Precision, Amplified. and a three-quarter studio shot of CNC aluminum planar headphones. (3) Three-column highlights for 106 mm Iso-Planar Driver, Zero-Resonance Billet Frame, and Hand-Matched Pairs. (4) Macro exploded machining cutaway. (5) Technical specifications table listing Impedance 32 Ohms, Sensitivity 98 dB/mW, Frequency Response 8 Hz-52 kHz, and Weight 410 g. (6) Minimal studio footer."
    }],
    "settings": {
      "skill": "webpage",
      "resolution": "2k"
    }
  }' -o solstice-task.json
jq -er '.id' solstice-task.json

이 페이로드에서 settings.length가 빠져 있고 contents에 prompt 항목 하나만 들어 있다는 점에 주목하세요. 전체 매개변수 규격은 Kling Image 4.0 Long Image API 레퍼런스에서 확인할 수 있습니다. [1]

실행 2: 참조 이미지 2장을 사용한 2K 이커머스 상세페이지 (2048 × 19533)

2048×19533 보태니컬 골드 이어링 이커머스 상세페이지의 4단 전체 보기

두 번째 실행에서는 settings.skill을 "ecommerce"로, settings.length를 "medium"으로 바꾸고 resolution은 "2k"를 유지했습니다. 그리고 기존 주얼리 사진 두 장을 refer_image 항목으로 전달했습니다. 조각된 골드 난초 드롭 이어링의 매크로 컷에는 id: "earring"을, 같은 이어링을 착용한 여성의 유리 온실 에디토리얼 인물 사진에는 id: "model"을 지정했습니다.

프롬프트에서는 각 섹션 설명 안에 @earring과 @model로 두 자산을 언급했습니다. API가 지정된 ID를 내부 위치 참조로 자동 변환해 주므로 인덱스를 직접 셀 필요가 없습니다. 모든 참조 사진은 30 MB 이하의 공개 JPEG 또는 PNG URL이어야 하며, 가로와 세로가 각각 최소 300 px 이상이고 가로세로 비율은 2:5에서 5:2 사이여야 합니다.

2K 이커머스 상세페이지 속 주석 달린 Craft And Beauty 디테일 섹션

medium 길이 2K 요청 한 번으로 세로 19,533 픽셀 분량의 완성된 이커머스 모듈 6개가 생성됐습니다. 샴페인 실크 배경의 제품 히어로, 감성적인 디자인 영감 섹션, 깔끔한 스튜디오 누끼 컷과 6행 상품 정보표(Phalaenopsis No. 4 Drop Earring, 18K Recycled Yellow Gold, 48 mm drop length, Forest-green velvet presentation box), @model의 인상을 충실히 유지한 On The Ear 착용 인물 컷, 6가지 각도의 제품 그리드(Front, Side, Back, Core Detail, Hook Detail, Profile), 그리고 위에서 확대한 주석형 Craft And Beauty 디테일 도해까지 한 번에 이어졌습니다.

원본 해상도 검수에서 실제 카탈로그에 바로 올리기 전에 꼭 짚어 둘 결함도 하나 발견했습니다. 사양표에는 정확한 모델명 Phalaenopsis No. 4 Drop Earring이 들어갔고 모든 도해 라벨의 철자도 깨끗했지만, 최상단 히어로 배너에서는 요청한 브랜드명 L'ORCHIDÉE 대신 Botanical Series를 BOTA SERIES와 BOTA — Drop Earring으로 줄여 표기했습니다. 긴 페이지의 텍스트 렌더링에서 자주 나타나는 패턴입니다. 짧은 본문 라벨과 사양표 행은 놀랄 만큼 안정적이지만, 스타일이 강하게 들어간 대문자 히어로 브랜드 마크는 종종 변형됩니다. 항상 전체 너비로 히어로 헤드라인을 검수하고, 법적으로 정확해야 하는 브랜드 로고나 필수 고지 문구는 스토어프론트 템플릿의 벡터 오버레이로 올리세요.

curl --fail-with-body -sS 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": "Create a luxury fine-jewelry ecommerce product detail page keeping exact fidelity to the brushed gold orchid earring in @earring and the editorial portrait in @model. Alternate warm champagne silk, alabaster ivory, and dark conservatory tones. (1) Hero product showcase on warm silk. (2) Design inspiration band. (3) Clean product info table listing Phalaenopsis No. 4 Drop Earring, 18K Recycled Yellow Gold, 48 mm drop length, Forest-green velvet presentation box. (4) On-the-ear editorial portrait using @model. (5) Six-angle product detail grid. (6) Annotated Craft And Beauty callout diagram highlighting Hand-Chased Petals, Satin Gold Finish, and Balanced Wire Hook."
      },
      {
        "type": "refer_image",
        "id": "earring",
        "url": "https://example.com/assets/gold-orchid-earring.png"
      },
      {
        "type": "refer_image",
        "id": "model",
        "url": "https://example.com/assets/editorial-portrait.png"
      }
    ],
    "settings": {
      "skill": "ecommerce",
      "length": "medium",
      "resolution": "2k"
    }
  }' -o orchidee-task.json
jq -er '.id' orchidee-task.json

대신 webpage 모드에서 참조 이미지를 사용할 때는 규칙 하나만 기억하세요. 시각적 방향성을 잡는 style_refer_image와 중심 제품을 고정하는 subject_refer_image에 각각 공백 없는 1~32자 영숫자 고유 id를 부여하고 프롬프트에서 @id로 언급하면 됩니다. 같은 contents 배열 안에서 ID를 중복해서는 안 됩니다.

여유 있게 상태를 조회하고 대용량 2K PNG 다운로드에 대비하세요

세로로 긴 레이아웃은 일반 단일 프레임 생성보다 소요 시간이 눈에 띄게 길고 결과 파일도 훨씬 무겁습니다. 5초 만에 끝나는 썸네일 API처럼 다루면 클라이언트 타임아웃이나 실수로 인한 중복 과금이 발생하기 쉽습니다.

11월 19일 실행에서 2048 × 16385 웹페이지는 169초(17 MB), 2048 × 19533 medium 이커머스 페이지는 261초(25 MB)가 걸렸습니다. long 2K 이커머스 페이지는 7분을 넘기고 50 MB를 초과할 수도 있습니다. POST /v1/images/generations가 응답하자마자 작업 ID를 즉시 저장해 두고, GET /v1/tasks/{id}를 15~20초 간격으로 조회하세요. 터미널 세션이 끊기거나 클라이언트가 타임아웃됐다고 해서 POST 요청을 다시 보내서는 안 됩니다. [2]

TASK_ID=$(jq -er '.id' orchidee-task.json)
curl --fail-with-body -sS "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" -o orchidee-result.json
jq -r '.status' orchidee-result.json

status가 completed로 바뀌면 output.data[0].url에서 단일 PNG URL을 추출하고, 전송 타임아웃을 넉넉하게 잡아 디스크로 바로 저장하세요.

IMG_URL=$(jq -er 'select(.status == "completed") | .output.data[0].url' orchidee-result.json)
curl --fail -L --max-time 300 "$IMG_URL" -o orchidee-2k.png

백엔드 워커에서는 PNG 전체를 작은 고정 메모리 버퍼에 올린 뒤 디스크나 오브젝트 스토리지에 쓰는 방식을 피하세요. HTTP 응답 본문을 파일로 바로 스트리밍하고, 모바일 스토어용으로 섹션을 자르기 전에 이미지 해상도를 확인한 다음, 화면 표시용 미리보기는 WebP로 변환하고 원본 PNG는 인쇄나 슬라이스 내보내기용으로 보관하는 것이 좋습니다.

8개 출력 등급과 참조 이미지 기준 예산 세우기

Kling Image 4.0 Long Image 요금은 skill(ecommerce 대 webpage), length(이커머스 모드의 short, medium, long), resolution(1k 대 2k) 세 가지 선택에 따라 달라집니다. 여기에 입력하는 모든 참조 이미지(refer_image, style_refer_image, subject_refer_image)마다 무료 할당량 없이 첫 번째 사진부터 입력 이미지 요금 1건이 추가됩니다.

덕분에 초안 제작 전략도 명확해집니다. 이커머스 카탈로그의 섹션 순서, 헤드라인 리듬, 색상 위계를 반복 수정할 때는 먼저 1k short 또는 medium으로 테스트해 세로 흐름을 확인하고, 브리프가 완성됐을 때 2k로 올리세요. 반면 웹페이지 레이아웃은 1k와 2k의 가격 차이가 크지 않으므로, 작은 글씨의 사양표까지 선명하게 보고 싶다면 처음부터 2k를 선택하는 편이 대체로 유리합니다. 첫 번째 실행은 정확히 webpage 2K 단가로 정산됐고, 두 번째 실행은 ecommerce medium 2K 단가에 입력 이미지 요금 2건이 더해졌습니다. 요청이 실패하면 요금이 부과되지 않습니다. 아래 표에서 현재 실시간 금액을 확인하거나 Kling Image 4.0 Long Image 요금 계산기에 실제 입력값을 넣어 계산해 보세요. [3]

Kling Image 4.0 Long Image 요금

카테고리요금 (USD)
Ecommerce · 1K · shortUS$0.2269
Ecommerce · 2K · shortUS$0.2723
Ecommerce · 1K · mediumUS$0.4538
Ecommerce · 2K · mediumUS$0.5294
Ecommerce · 1K · longUS$0.7563
Ecommerce · 2K · longUS$0.8319
Webpage · 1KUS$0.5294
Webpage · 2KUS$0.5748
참조 이미지US$0.003025

자주 묻는 질문

ecommerce 모드에서 short, medium, long은 어떻게 고르나요?

length를 선택하기 전에 제품에 실제로 필요한 독립 모듈 수부터 세어 보세요. short는 히어로, 핵심 장점, 간단한 사양 블록처럼 집중된 3~4개 밴드에 맞습니다. medium은 위 주얼리 실행처럼 6개 섹션(히어로, 스토리, 스튜디오 누끼, 사양표, 라이프스타일 착용 컷, 다각도 그리드 및 디테일 도해)을 여유 있게 담습니다. long은 비교 차트, 단계별 사용법 패널, 패키징 구성까지 타이포그래피가 답답해지지 않게 넣어야 하는 테크 하드웨어나 다중 SKU 상품에 활용하세요.

webpage 요청에서 HTTP 400 오류가 왜 발생하나요?

가장 흔한 검증 실수 두 가지는 skill: "webpage"와 함께 settings.length를 보내는 것과, 참조 사진에 style_refer_image나 subject_refer_image 대신 type: "refer_image"를 붙이는 것입니다. 두 필드 모두 ecommerce 모드 전용입니다. 또한 프롬프트가 가중 글자 수 제한(@id 매핑 이후 기준 en / 166000 + non_en / 71000 <= 1) 안에 드는지, resolution이 "1k" 또는 "2k"인지도 함께 확인하세요.

실제 온라인 스토어에 올릴 때는 완성된 PNG를 잘라야 하나요?

네. 2048 × 19533 PNG는 비압축 기준으로 17~25 MB에 달해 모바일 네트워크에서 단일 <img> 태그로 바로 서빙하기에는 너무 무겁습니다. 완성된 페이지를 가로 밴드 경계에 맞춰 슬라이스하고 각 밴드를 WebP나 AVIF로 압축해 점진적으로 빠르게 로딩되도록 구성하세요. 법적 표기, 가격, 구매 버튼처럼 정확한 정보가 필요한 요소는 실제 HTML 텍스트로 교체하는 것이 좋습니다. 파이프라인을 자동화하기 전에 Kling Image 4.0 Long Image 플레이그라운드에서 프롬프트를 시험하고 전체 세로 결과물을 직접 확인해 볼 수 있습니다.

출처

  1. Kling Image 4.0 Long Image SeedRouter API 레퍼런스
  2. SeedRouter 작업 상태 조회 및 결과 가져오기 안내
  3. Kling Image 4.0 Long Image 실시간 요금 및 계산기

관련 가이드