소개
장면, 포스터, 캐릭터를 설명하면 완성된 이미지를 받습니다. 요청마다 해상도, 화면 형태, 독립적인 결과의 개수를 선택합니다.
| 항목 | 값 |
|---|---|
| 입력 | 텍스트 |
| 출력 | 이미지 |
| 발행사 | 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자까지 입력할 수 있습니다. 피사체, 동작, 장소, 카메라, 조명을 적고 이미지에 넣을 글자는 따옴표로 묶어 주십시오. 1자 이상 · 21000자 이하 |
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은 프롬프트가 필수이며 2k, 4k, 8k에서 요청당 한 장부터 아홉 장까지 독립 이미지를 제공합니다. 차 축제 포스터, 새벽 항구, 잉크와 수채화의 고사리를 생성했습니다.
묶음 생성은 같은 지시에서 독립적인 대안을 만듭니다. 검토할 수 있는 수량을 선택하고 조율된 이미지 모음에는 관련 Set 모델군을 사용합니다.
요청 설정
프롬프트는 필수입니다. 나머지는 출력 수, 해상도, 형태를 정하며 생략하면 아래 기본값을 사용합니다.
| 매개변수 | 입력값 | 기본값 | 역할 |
|---|---|---|---|
prompt | 필수 문자열, 1`21,000자 | 없음 | 대상, 배경, 조명, 정확한 문구를 설명합니다. |
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 | 고정 구도 또는 지시 해석에 맡깁니다. |
전달 용도에 맞는 해상도와 배치 위치에 맞는 비율을 선택합니다. 레이아웃에 사용할 때 반환 파일의 실제 크기를 확인합니다. 아래 예시는 요청에서 반환된 크기를 보여줍니다.
그릴 구도를 전달
눈에 보이는 대상과 배경부터 시작해 조명과 표현을 지정합니다. 항구에는 목조 어선, 새벽 안개, 옅은 금빛을 넣었습니다. 고사리에는 식물, 미색 종이, 가는 잉크 선, 차분한 녹색 수채화를 지정했습니다. 일반적인 품질 칭찬보다 보일 내용을 설명합니다.
글자 지시는 별도로 작성
포스터에서는 제목을 따옴표로 지정하고 위치를 정합니다. 필수 문구와 삽화 방향을 분리하고 추가 문구가 문제가 된다면 “다른 단어를 넣지 말 것”을 덧붙입니다. 요청하지 않은 작은 문구까지 전체 이미지를 교정합니다.
Kling에 따르면 한 그림에 생성 글자 2,000자까지 넣을 수 있습니다. 프롬프트의 21,000자 제한과 구분합니다. 전자는 그림 속 글자이고 후자는 전체 설명입니다. 제목과 보조 문구를 위치별로 묶으면 레이아웃 지시를 읽기 편하게 합니다.
장면과 화면 맞추기
용도가 정해졌다면 고정 비율을 선택합니다. 세로 포스터와 가로 편집 장면은 서로 다른 구도가 필요합니다. 프롬프트에 형태를 맡길 때는 auto를 사용합니다. 초안을 검토하고 해상도를 바꾸면 이전 구도와 글자가 그대로 이어진다고 가정하지 말고 새 이미지를 확인합니다.
11월 18일 생성 결과
텍스트 기반 생성 세 번은 대상, 해상도, 화면 형태를 달리했습니다. 이미지 계획 시 예시의 구성, 표면 표현, 글자를 살펴봅니다.
2k 차 축제 포스터
SLOW STEEP는 3:4를 사용했고 1760 x 2336 PNG 한 장을 반환했습니다. 크림색 종이의 남색 판화풍 찻주전자 위에 제목이 정확했습니다. 보조 문구는 모델이 만들었습니다. 사용 전에 제목과 보조 문구를 함께 확인합니다.
4k 항구
새벽 항구는 16:9를 사용했고 목조 배, 안개, 옅은 새벽빛의 5440 x 3072 PNG 한 장을 반환했습니다. 넓은 구도 안에 배와 안개, 주변 항구가 자리합니다.
8k 고사리
정사각형 식물 생성은 미색 종이에 잉크와 수채화로 고사리를 그린 8192 x 8192 PNG 한 장을 반환했습니다. Kling은 8k를 네이티브 생성으로 설명합니다. 예시에서 가는 선, 색 표현, 정사각형 구도를 확인합니다.
가격과 검토 판단
선택한 해상도의 페이지 표시 가격을 확인합니다. 전달된 이미지마다 해당 요금이 부과되며 독립 출력이 많아지면 결제와 검토 대상도 늘어납니다. 비율은 가격을 바꾸지 않습니다. 다른 해상도나 추가 묶음을 결정하기 전에 선택한 단계의 구성을 검토합니다.
범위와 관련 모델군
이 엔드포인트는 원본 이미지 대신 텍스트를 받습니다. 기존 물체나 사진을 결과에 반영하려면 이 페이지의 이미지 편집을 사용합니다.
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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k",
"num_outputs": 1,
"aspect_ratio": "auto"
}
}'
# 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 레퍼런스에서 확인하세요.















