소개
이미지 1~10장을 업로드하고 지시문에서 번호로 부른 뒤 변경 내용을 설명합니다. 사진 스타일 변경, 피사체 이동, 인물과 의상과 제품의 조합에 활용합니다.
| 항목 | 값 |
|---|---|
| 입력 | 이미지 |
| 출력 | 이미지 |
| 발행사 | Kling |
| 출시일 | 2026년 11월 17일 |
| 작업 | 텍스트 기반 이미지 생성; 이미지 편집 |
| 프롬프트 길이 | 1~21,000자 |
| 해상도 단계 | 2k(기본값), 4k, 8k |
| 독립 출력 | 요청당 1~9장; 기본값 1장 |
| 출력 비율 | auto(기본값), 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 |
| 편집 참조 | 업로드 순서로 지정하는 이미지 1~10장 |
| 참조 형식 | JPG 또는 PNG |
| 참조 파일 크기 | 이미지당 30 MB까지 |
| 참조 이미지 크기 | 각 변 300 px 이상; 비율 2:5~5:2 |
| 과금 기준 | 전달된 이미지마다 해상도에 따라 과금하며, 편집은 참조 이미지별 입력 요금도 부과합니다 |
핵심 기능 및 하이라이트
정확한 제목과 확인할 추가 문구
SLOW STEEP 생성은 크림색 종이의 남색 판화풍 찻주전자 위에 요청한 제목을 배치했습니다. 보조 문구도 만들어 넣었습니다. 이 2k 결과는 포스터 지시에 들어갈 단어와 추가 문구의 범위를 정해야 하는 이유를 보여줍니다.
4k의 배와 새벽 안개
항구 프롬프트는 목조 어선, 안개, 옅은 금빛을 지정했습니다. 결과는 이를 가로 새벽 장면에 담아 4k 단계의 5440 x 3072 PNG로 반환했습니다. 편집용 이미지를 계획할 때 예시의 배와 부드러운 빛을 살펴봅니다.
8192픽셀 고사리 삽화
식물 생성은 미색 종이에 가는 잉크 선과 차분한 녹색 수채화를 담은 8192 x 8192 PNG를 반환했습니다. 예시에서 정사각형 구성과 그린 윤곽선에 수채화를 결합한 표현을 확인합니다.
호박색 바탕에 다시 그린 장미
편집은 참조 장미를 알아볼 수 있게 유지하며 손으로 그린 빈티지 광고로 바꿨습니다. 요청하지 않은 ROSE와 NATURAL ESSENCE도 넣었습니다. 대상의 보존만큼 추가 문구도 주의 깊게 확인합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수 항목이며 21,000자까지 입력할 수 있습니다. 업로드한 이미지를 @ |
image_urls | 예 | 참조 이미지 1 |
num_outputs | 아니요 | 반환할 독립적인 결과 수로 1~9장을 지정합니다. 기본값은 1장이며 전달된 이미지마다 요금이 청구됩니다. |
resolution | 아니요 | 출력 등급으로 2k, 4k, 8k 중에서 선택하며 기본값은 2k입니다. 등급이 높을수록 장당 요금이 올라갑니다. |
aspect_ratio | 아니요 | 결과 형태로 auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 중에서 선택합니다. 기본값 auto는 프롬프트와 참조 이미지를 따릅니다. |
요금
전달된 이미지마다 선택한 해상도의 요금이 청구되며, 참조 이미지마다 소액의 입력 요금이 추가됩니다.
| 사양 | 요금 |
|---|---|
| $0.063 / 장 |
| $0.094 / 장 |
| $0.157 / 장 |
활용 사례
차 축제 포스터
행사 제목을 따옴표로 지정하고 종이 색과 중앙 삽화를 설명합니다. 2k SLOW STEEP 포스터는 남색 찻주전자 위에 제목을 정확히 표현했지만 보조 문구도 추가했으므로 전달 전에 원고를 검토해야 합니다.
편집 레이아웃용 항구 장면
보이는 사물과 빛으로 장소를 설명하고 배치할 위치에 맞는 가로 구도를 선택합니다. 4k 항구 생성은 목조 어선, 안개, 옅은 새벽빛을 담은 5440 x 3072 PNG를 반환했습니다.
큰 레이아웃을 위한 식물 삽화
해상도 선택 전에 식물, 종이, 선, 색 표현을 지정합니다. 정사각형 8k 고사리는 미색 종이에 잉크와 차분한 녹색 수채화를 표현한 8192 x 8192 PNG로 반환됐습니다.
참조 이미지 기반 광고 구상
기존 제품 사진을 편집에 넣고 새로운 표현을 설명합니다. 장미 편집에서는 호박색 배경에서도 대상을 알아볼 수 있었지만, 추가된 ROSE와 NATURAL ESSENCE는 검토가 필요했습니다.
프롬프트 가이드 및 실전 팁
시작할 소재 선택
글로 설명하는 장면에는 텍스트 기반 생성을 사용합니다. 기존 이미지에서 대상이나 시각적 방향을 가져오려면 이미지 편집을 선택합니다.
장면 또는 변경 사항 설명
대상, 배경, 조명, 그릴 문구를 정확하게 지정합니다. 편집할 때는 업로드 순서대로 @image_1과 @image_2를 지정하고 변경할 부분과 유지할 부분을 구분합니다.
화면 비율과 출력 수 설정
2k, 4k, 8k와 지원 비율을 선택하거나 auto를 유지합니다. 독립 이미지 한 장부터 아홉 장까지 요청하고 해상도와 참조 입력에 따른 표시 가격을 확인합니다.
문구와 이미지 세부 확인
글자는 제공한 원고와, 편집된 대상은 참조 이미지와 비교합니다. 차 축제 포스터와 장미 광고에는 요청하지 않은 문구가 생겼습니다. 엄격한 구성이 필요하면 “다른 단어를 넣지 말 것”을 추가하고 결과를 교정합니다.
변경 사항을 정해 이미지 편집
다음 디자인에서 원본 대상이나 표현이 중요할 때 기존 이미지를 가져옵니다. Kling Image 4.0 편집은 프롬프트와 참조 이미지 한 장부터 열 장까지 받습니다. 지시는 각 참조 역할, 변경 사항, 알아볼 수 있게 유지할 세부를 설명합니다.
장미 편집은 참조를 호박색 배경의 손그림 빈티지 광고로 바꿨습니다. 장미는 알아볼 수 있었지만 불필요한 글자도 생겼습니다. 전달할 결과를 고르기 전에 대상과 전체 구성을 함께 확인합니다.
참조 이미지와 설정 준비
번호를 작성하기 전에 형식과 업로드 순서를 확인합니다. 각 참조와 역할을 연결해 번호와 지시를 일치시킵니다.
매개변수 표
프롬프트와 참조 모음은 필수입니다. 출력 수, 해상도, 비율은 선택 사항이며 아래 기본값을 사용합니다.
| 매개변수 | 입력값 | 기본값 | 사용법 |
|---|---|---|---|
prompt | 필수 문자열, 1`21,000자 | 없음 | 참조를 지정하고 변경과 보존을 구분합니다. |
image_urls | 필수 배열, 이미지 1`10장 | 없음 | 인용 순서대로 JPG 또는 PNG를 제공합니다. |
num_outputs | 1`9 정수 | 1 | 독립 편집 결과를 요청합니다. |
resolution | 2k, 4k, 8k | 2k | 이미지 요금에 사용하는 단계를 선택합니다. |
aspect_ratio | auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 | auto | 형태를 고정하거나 지시와 참조에 맡깁니다. |
참조마다 30 MB까지, 각 변 300 px 이상, 비율 2:5`5:2여야 합니다. 이는 입력 이미지 조건입니다. 원본 크기로 출력 구도가 결정된다고 가정하지 말고 별도로 선택합니다.
각 소재의 역할을 설명
완성 표현 전에 각 원본의 역할을 분명히 합니다. 예를 들어 @image_1의 도자기와 @image_2의 배색을 요청합니다. 이어서 배경과 표현을 지정하고 보존할 세부와 변경을 구분합니다.
입력 순서와 인용 맞추기
참조 배열 시작을 @image_1, 다음 항목을 @image_2로 지정하고 순서대로 이어갑니다. 각 번호에 대상, 배색, 표현 역할을 붙입니다. 변경이 원본 세부와 충돌하면 바꾸려는 부분을 명시해 방향을 정합니다.
보존할 부분을 구체화
물병 손잡이 형태, 꽃 윤곽, 제품 무늬처럼 중요한 특징을 명시합니다. 그다음 그린 표면, 다른 배경색, 새로운 배치를 설명합니다. 반환 결과는 원본과 비교합니다. 보존 지시가 실제 비교를 대신하지는 않습니다.
스타일 변경 중에도 문구 제어
“빈티지 광고”는 장르를 설명하지만 모델이 문구를 만들 여지를 남깁니다. 넣을 글자를 정확히 지정하거나 필요 없다면 글자를 넣지 않도록 요청합니다. “다른 단어를 넣지 말 것”으로 범위를 정하고 확인합니다. 장미 결과는 시각적 스타일을 바꿀 때도 글자를 확인해야 하는 이유를 보여줍니다.
관찰한 결과: 호박색 바탕의 장미
amber-rose-vintage-ad는 참조 이미지, 2k, 2:3 비율, 출력 한 장을 사용했습니다. 1664 x 2496 PNG 한 장을 반환했습니다. 장미는 알아볼 수 있었고 호박색 배경에 다시 그려져 손그림 지시를 반영했습니다.
요청 없이 나타난 단어
같은 결과에 ROSE와 NATURAL ESSENCE가 들어갔습니다. 두 문구 모두 지시에 없었습니다. 원래 대상을 보존했더라도 광고 전달 전에 검토할 결함으로 취급합니다. 주요 대상 주변의 작은 문구까지 모든 글자를 요청한 원고와 비교합니다.
참조 추가 전 요금 이해
선택한 해상도의 표시 가격을 확인합니다. 전달된 이미지마다 해당 단계 요금이 부과되고 참조마다 소액의 입력 요금도 추가합니다. 편집에 맞는 참조 목록으로 각 소재의 역할과 입력 비용을 판단합니다. 독립 출력 수를 늘리면 검토할 이미지도 증가합니다.
전달할 결과에 맞는 방식 선택
원본 이미지가 필요 없으면 텍스트 기반 생성을 사용합니다. 입력이 대상이나 시각적 방향을 제공할 때 편집을 사용합니다. 수정할 세부를 정하고 유지할 특징과 함께 변경을 설명합니다. 선택 전에 새 결과마다 원본과 비교합니다.
Kling은 시리즈 방식이 관련 이미지를 계획하고 긴 이미지 방식이 제품 상세나 웹페이지 전체 시각물을 만든다고 설명합니다. 모음에는 Kling Image 4.0 Set(kling/image-4.0-set), 긴 페이지에는 Kling Image 4.0 Long(kling/image-4.0-long)을 선택합니다. 여기의 독립 편집 한 장부터 아홉 장까지를 조율된 시리즈로 취급하지 않아야 합니다. 다른 모델과 비교할 때 같은 참조와 변경 지시를 사용하고 대상 보존, 배경 변화, 추가 글자를 함께 살펴봅니다.
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/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"num_outputs": 1,
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k"
}
}'
# 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 레퍼런스에서 확인하세요.















