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

Image

Kling Image 4.0 Long Image

View Markdown

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(약 25개 섹션), medium(기본값, 약 610개 섹션) 또는 long(약 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 스키마를 참조하세요.