소개
시퀀스 전체에 대한 브리프를 하나 작성하면 이미지를 순서대로 받습니다. 인물, 의상, 제품이 계속 등장해야 한다면 참조 이미지를 최대 10장까지 추가합니다.
| 항목 | 값 |
|---|---|
| 입력 | 텍스트 |
| 출력 | 이미지 |
| 발행사 | Kling |
| 출시일 | 2026년 11월 17일 |
| 요청당 이미지 수 | 2~10장, 기본값 4장 |
| 프롬프트 길이 | 1~21,000자 |
| 해상도 옵션 | 2k(기본값), 4k, 8k |
| 출력 화면비 | 기본값은 auto이며 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9도 지원합니다. |
| 공통 참조 이미지 | 선택 사항이며 10장까지 지원합니다. |
| 참조 형식 | JPG 또는 PNG |
| 참조 파일 크기 | 이미지당 30 MB 이하 |
| 참조 이미지 크기 | 각 변 300 px 이상 |
| 참조 화면비 | 2:5~5:2 |
| 과금 기준 | 선택한 해상도에서 제공된 이미지별 요금에 참조 이미지별 입력 요금을 더합니다. |
핵심 기능 및 하이라이트
같은 선반의 장미를 두 조명으로 비교합니다
두 장을 요청한 실행에서는 제품 참조 한 장을 사용하고 제품을 동일하게 유지하도록 지시했습니다. 아침 결과에는 저녁 이미지와 같은 나무 선반 위에 같은 장미가 나타났습니다. 두 파일 모두 2k 설정에서 반환된 2048 × 2048 PNG였습니다.
따뜻한 램프 빛이 장면을 바꿉니다
함께 반환된 이미지에서는 장미와 나무 선반이 따뜻한 탁상램프 아래에 놓입니다. 옅은 아침빛 이미지와 같은 요청에서 나왔으며, 출력은 두 장이고 화면은 정사각형입니다. 두 이미지를 비교하여 유지된 대상과 선반, 요청한 조명 변화가 함께 어떻게 표현되었는지 확인합니다.
프레임마다 명확한 역할을 부여합니다
공통 요구 사항을 한 번 작성한 뒤 이미지를 순서대로 설명합니다. 요청에서는 출력 2~10장, 공통 참조 10장까지, 해상도 2k·4k·8k를 지정할 수 있습니다. 개수, 형태, 해상도는 별도로 결정하며 각각 검토하려는 시리즈에 맞춥니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수 항목이며 21,000자까지 입력할 수 있습니다. 시리즈 전체의 규칙을 적은 뒤 각 이미지를 순서대로 설명합니다. 1자 이상 · 21000자 이하 |
reference_image_urls | 아니요 | 선택 항목으로 시리즈 전체가 공유할 이미지를 최대 10장까지 지정합니다. 파일은 JPG 또는 PNG 형식이며 30MB 이하, 각 변 300px 이상, 화면비 2:5~5:2여야 합니다. 10개 이하 |
num_outputs | 아니요 | 시리즈의 이미지 수로 2~10장을 지정합니다. 기본값은 4장이며 전달된 이미지마다 요금이 청구됩니다. |
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 / 장 |
활용 사례
제품 조명 연구
제품과 배치를 고정하도록 요청하면서 조명 조건을 바꿔 비교합니다. 장미 요청에서는 같은 선반 장면을 아침빛과 저녁 램프 빛으로 표현한 이미지가 반환되었습니다.
공예 작업 과정 보드
공방 작업을 번호가 있는 단계로 설명하고 num_outputs를 계획한 순서에 맞춥니다. 과정 보드 전체에서 유지할 도구, 재료, 작업 공간의 세부 사항을 지정합니다.
카탈로그 촬영 각도 기획
공통 참조 이미지와 유지할 세부 사항 목록을 제공하고 이미지마다 다른 제품 각도를 지정합니다. 카탈로그 자료를 선택하기 전에 반환된 제품을 참조 이미지와 대조합니다.
캠페인 구도 연구
공통 대상과 색상 팔레트를 유지하면서 이미지마다 다른 구도를 지정합니다. 사용할 지면에 맞는 지원 화면비를 선택하고 전체 이미지의 시각적 연속성을 검토합니다.
프롬프트 가이드 및 실전 팁
공통 대상을 정의합니다
시리즈를 연결하는 제품, 장소 또는 직업을 주제로 한 대상을 설명합니다. 개별 이미지를 나열하기 전에 유지할 세부 사항을 명시합니다.
이미지마다 목적을 부여합니다
필요한 순서대로 이미지에 번호를 붙이고 이미지별로 하나의 시점이나 순간을 설명합니다. num_outputs를 해당 개수에 맞춰 2~10으로 설정합니다.
참조를 연결하고 화면을 설정합니다
시각적 기준이 필요하면 공통 참조 이미지를 추가하고 @
image_1, @image_2로 지정합니다. 시리즈의 해상도와 화면비를 선택합니다.전체 시퀀스를 검토합니다
반환된 모든 이미지에서 대상의 세부 사항과 구도를 비교합니다. 장미 예시는 기획안을 작성하기 전에 살펴볼 수 있는 두 장의 조명 비교를 제공합니다.
공통 대상을 중심으로 시퀀스를 구성합니다
Kling Image 4.0 Set 엔드포인트는 서로 관련된 이미지 2~10장을 위한 기획안을 받습니다. 시리즈 전체를 설명한 뒤 각 이미지의 순서와 시각적 목적을 지정합니다. 선택적 참조 이미지는 요청 전체에 적용되므로 제품 사진을 조명 연구나 여러 시점의 기준으로 사용할 수 있습니다.
계획할 때 구분할 요소는 연속성입니다. 어떤 세부 사항을 알아볼 수 있게 유지하고 무엇을 바꿀지 결정합니다. 조명 연구에서는 제품과 그 배치를 고정 요소로 명시한 뒤 이미지마다 다른 광원을 지정합니다. 과정 시퀀스에서는 작업 공간을 한 번 정의하고 각 단계의 작업을 설명합니다.
요청 매개변수
다음은 이 엔드포인트의 공개 필드입니다. 요청한 이미지 개수와 프롬프트의 번호별 설명이 일치하도록 합니다.
| 필드 | 필수 여부 | 선택 항목과 제한 | 역할 |
|---|---|---|---|
prompt | 필수 | 1~21,000자 | 시리즈, 순서대로 나열한 이미지, 유지할 세부 사항을 설명합니다. 참조는 @image_1, @image_2로 지정합니다. |
reference_image_urls | 선택 | JPG 또는 PNG 파일 10장까지 | 공통 시각 참조로 사용합니다. 파일마다 30 MB 이하, 각 변 300 px 이상, 화면비 2:5~5:2여야 합니다. |
num_outputs | 선택 | 2~10, 기본값 4 | 요청할 관련 이미지 개수를 지정합니다. |
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 | 시리즈의 형태를 지정합니다. auto는 프롬프트와 참조를 바탕으로 선택합니다. |
이미지와 참조는 따로 계산합니다
참조는 시각적 입력을 제공하며 시리즈의 이미지 개수를 정하지는 않습니다. 장미 요청에서는 참조 한 장을 사용하고 num_outputs를 두 장으로 설정했습니다. 업로드 수가 출력 개수를 결정한다고 가정하지 말고 필요한 개수를 의도적으로 선택합니다.
제공되는 시리즈의 예산을 계획합니다
이미지 시리즈의 비용은 선택한 해상도에 해당하는 이 페이지의 표시 요금으로 계산합니다. 제공된 각 이미지에는 해당 요금이 적용되고 각 참조 이미지에는 소액의 입력 요금이 추가됩니다. 따라서 시리즈는 단일 이미지로 계산하는 대신 제공된 이미지와 참조 입력을 합쳐 과금합니다. 요청을 제출하기 전에 출력 개수, 해상도, 참조 수를 함께 확인합니다.
고정할 세부 사항과 계획한 변화를 기획안에 작성합니다
공통 대상, 배경, 시각적 표현부터 작성합니다. 이어서 번호별 이미지 설명과 명확한 유지 지시를 추가합니다. 제품 비율, 선반에서의 위치, 카메라 시점, 조명처럼 검토자가 확인할 수 있는 세부 사항에 프롬프트 분량을 사용합니다.
이미지마다 하나의 시각적 작업을 지정합니다
제품 시리즈에서는 한 이미지가 제품을 소개하고 다른 이미지가 다른 빛 아래의 모습을 보여 줄 수 있습니다. 공방 과정에서는 각 이미지가 명시된 단계를 표현할 수 있습니다. 각 이미지의 차이를 설명하여 요청에 유용한 흐름을 부여합니다.
참조마다 역할을 명시합니다
@image_1의 제품이나 @image_2의 배경을 지정한 뒤 각 참조에서 시리즈가 유지할 요소를 설명합니다. 번호가 입력 순서와 일치하는지 확인합니다.
형태와 해상도를 의도적으로 선택합니다
시리즈는 화면비 설정과 해상도 등급을 공유합니다. 정사각형 레이아웃이 필요하면 형태를 auto에 맡기는 대신 1:1을 선택합니다. 장미 실행에서는 1:1과 2k를 선택했습니다. 작업에 다른 등급이 적합한지 결정하기 전에 구도와 유지된 대상의 세부 사항을 검토합니다.
장미 요청에서 반환된 결과를 확인합니다
2026년 11월 18일, 참조 제품을 나무 선반 위에서 두 가지 조명 조건으로 표현하도록 프롬프트를 제출했습니다. 설정은 참조 한 장, 출력 두 장, 해상도 2k, 화면비 1:1이었습니다. 요청에서 2048 × 2048 PNG 두 장이 반환되었습니다.
같은 기획안으로 아침과 저녁을 표현합니다
아침 이미지에는 옅은 빛 아래 나무 선반에 놓인 장미가 나타납니다. 함께 나온 이미지는 같은 장미와 같은 선반을 따뜻한 탁상램프 아래에서 보여 줍니다. 두 시점 모두 같은 요청에서 나왔습니다. 유지 목표와 요청한 조명 변화를 평가할 때 두 이미지를 함께 비교합니다.
이미지를 고르기 전에 전체를 검토합니다
반환된 이미지를 함께 놓고 프롬프트의 공통 요구 사항과 비교합니다. 제품 연구에서는 계획한 조명 변화뿐 아니라 제품 비율과 위치도 살핍니다. 과정 보드에서는 요청한 모든 단계가 있는지, 작업 공간의 세부 사항이 시퀀스를 연결하는지 확인합니다. 특정 시점에 수정이 필요하면 공통 지시를 명확하게 유지하면서 해당 이미지 설명을 더 구체적으로 작성합니다.
제한과 관련 선택지를 확인합니다
이미지 수는 2~10장이어야 하며 프롬프트는 21,000자 이내여야 합니다. 모든 참조가 표의 파일, 크기, 화면비 요구 사항에 맞는지 확인합니다. 시리즈 생성에도 시각적 검토가 필요합니다. 카탈로그나 캠페인에 사용하기 전에 반환된 모든 이미지의 제품 세부 사항과 의도한 변화를 비교합니다.
독립적인 이미지 기획에는 Kling Image 4.0을 비교합니다. 이어지는 페이지 구성에는 Kling Image 4.0 Long을 고려합니다. Kling의 설명에 따르면 긴 이미지 모드는 완전한 페이지 이미지 한 장을 생성합니다. 결과물에 개별 이미지가 필요한지, 이어지는 페이지 레이아웃이 필요한지에 따라 선택합니다.
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-set/text-to-image",
"input": {
"aspect_ratio": "auto",
"num_outputs": 4,
"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 레퍼런스에서 확인하세요.













