메인 콘텐츠로 건너뛰기
POST
model: "kling-v4-long-image"로 POST /v1/images/generations에 비동기 요청을 제출합니다. data[0].task_id를 얻은 후 GET /v1/tasks/{task_id}로 조회합니다. 요청당 긴 PNG 한 장을 반환하며 웹페이지 모드의 결과도 디자인 이미지입니다.

모드 선택

인증

string
필수
Authorization: Bearer <token>을 사용합니다. <token>은 APIMart API 키입니다.

요청 매개변수

string
필수
kling-v4-long-image로 지정합니다.
boolean
기본값:"false"
이미지 작업을 제출하기 전에 콘텐츠 검토를 실행할지 여부를 지정합니다.
  • true: omni-moderation-latest로 프롬프트와 입력 이미지를 검토
  • false 또는 생략: 검토 요청을 보내지 않으며 검토 비용이나 지연이 추가되지 않음(기본값)
string
필수
필수이며 공백만으로 구성할 수 없습니다. 영어만 사용하면 최대 166,000자, 중국어 등만 사용하면 최대 71,000자이며 혼합 언어는 비율에 따라 계산합니다. 레이아웃, 섹션, 문구, 스타일과 피사체를 설명하세요.
string
필수
필수: ecommerce는 상품 상세 페이지, webpage는 웹페이지 디자인입니다. 대소문자를 구분하지 않으며 모드에 따라 참조 이미지 필드가 다릅니다.
string
기본값:"medium"
skill: "ecommerce" 전용: short, medium(기본값), long. 대략 2–5, 6–10, 11–18개의 콘텐츠 섹션에 해당하며 실제 내용과 높이는 결과에 따라 달라집니다. 웹페이지 모드에서는 생략해야 하며 전달하면 HTTP 400입니다.
string
기본값:"1K"
1K(기본값)와 2K를 지원하고 대소문자를 구분하지 않습니다. 모든 상품 페이지 길이에서 두 해상도를 사용할 수 있으며 long + 2K도 지원합니다. 출력 너비는 각각 1024 px와 2048 px이고 높이는 내용에 따라 달라집니다. 4K는 지원하지 않습니다.
string[]
상품 페이지 전용이며 상품 이미지 1–3장이 필수입니다. 웹페이지에서는 생략하고 image_with_roles를 사용하세요. 공개 접근 가능한 이미지 직접 URL을 전달합니다. 로컬 파일은 이미지 업로드 API를 사용한 후 반환된 url을 전달하세요.
object[]
웹페이지 전용이며 선택 사항입니다. style과 subject 각각 최대 1장으로, 한쪽 또는 양쪽 모두 생략할 수 있습니다. 상품 페이지에서는 이 필드를 생략하세요.
integer
요청당 긴 이미지 한 장을 생성합니다. 생략하거나 정수 1을 전달할 수 있으며 다른 값은 HTTP 400입니다.
boolean
생략하거나 false를 전달할 수 있습니다. true는 HTTP 400입니다.
size, aspect_ratio, width, height, mask_url, sequential_image_generation, sequential_image_generation_options는 전달하지 마세요. 값이 null이나 빈 문자열이어도 HTTP 400입니다.

참조 이미지 요건 및 참조 방법

JPG / JPEG / PNG를 지원합니다. 장당 최대 30 MB, 너비와 높이 각각 최소 300 px, 비율은 2:5–5:2입니다. URL의 HTTP 403 / 404 / 410 응답, 크기나 비율 위반, 용량 초과는 동기 HTTP 400으로 거절되며 작업과 생성 요금이 발생하지 않습니다. 원본 서버 시간 초과 등 다른 가져오기 오류는 접수 후 작업이 실패하고 선차감 요금이 환불됩니다. 프롬프트에서 @Image1, @Image2 등으로 참조합니다. 상품 페이지는 image_urls 순서, 웹페이지는 스타일 이미지 다음 피사체 이미지 순서입니다. 한 역할만 전달하면 @Image1입니다.

요청 예제

아래 요청은 POST /v1/images/generations로 보냅니다. 예제 URL을 실제 접근 가능한 직접 링크로 바꾸세요.

상품 긴 페이지: long + 2K

스타일 및 피사체를 참조한 웹페이지

프롬프트만으로 웹페이지 생성

작업 조회

작업 조회 API를 약 10초 간격으로 조회하세요. task_id를 보관하고 오래 걸리더라도 생성 요청을 중복 제출하지 마세요.
아래는 성공 결과의 구조 예시입니다. images와 url은 모두 배열이며 이 모델은 요청당 긴 이미지 한 장을 반환합니다.
data.result.images[0].expires_at에 표시된 초 단위 Unix 타임스탬프 이전에 다운로드하세요. 이후 링크는 만료됩니다.
생성에는 보통 몇 분이 걸리며 long + 2K의 한 실측 샘플은 432초였습니다. estimated_time은 현재 60초로 고정되어 있으므로 완료 카운트다운이나 시간 초과 기준으로 사용하지 마세요. 소요 시간은 내용과 서비스 부하에 따라 달라지며 샘플은 상한이 아닙니다.높이와 파일 용량은 내용에 따라 달라집니다. 한 long + 2K 샘플은 2048×46615, 63.9 MB였으며 이는 출력 제한이 아닙니다. 결과가 50 MB를 넘을 수 있으므로 큰 이미지의 다운로드와 표시 비용을 고려하세요.

요금

요청당 선택한 출력 등급의 긴 이미지 한 장과 참조 이미지 요금을 계산합니다. 출력 등급 단가 + 참조 이미지 수 × 참조 이미지 단가. 상품, 스타일, 피사체 이미지 모두 계산되며 첫 참조 이미지도 유료입니다. 출력 등급은 아래 8가지입니다. 가격 키는 kling-v4-long-image@<등급>, 참조 이미지는 kling-v4-long-image@input입니다. 생성 요청의 resolution에는 여전히 1K 또는 2K만 전달합니다. 제출 시 선차감하고 성공 시 정산하며 실패 시 전액 환불합니다. 단가와 계정 할인은 가격 페이지를 확인하세요.

주요 오류

아래 검증 오류는 동기 HTTP 400을 반환하며 작업과 생성 요금이 발생하지 않습니다. 제출 오류는 error.message, 작업 생성 후 실패는 data.error.message를 확인하세요.