이미지 생성
POST
/kling/v1/images/generations
텍스트 프롬프트와 선택적 참조 이미지로 이미지 생성 작업을 만듭니다.
Authorizations
bearer
Type
HTTP (bearer)
Request Body
application/json
model_name
string
Required
모델 이름. 열거값: kling-v1, kling-v1-5, kling-v2, kling-v2-new, kling-v2-1, kling-v3
prompt
string
Required
긍정 텍스트 프롬프트(최대 2500자)
negative_prompt
string
부정 텍스트 프롬프트(최대 2500자)
image
string
참조 이미지(Base64 또는 접근 가능한 이미지 URL)
image_reference
string
이미지 참조 유형.
열거값: subject(캐릭터 특징 참조), face(얼굴 유사도 참조).
face 사용 시 업로드 이미지에 얼굴이 정확히 1개 있어야 합니다.
kling-v1-5이고 image가 비어 있지 않으면 필수입니다.
image_fidelity
number
생성 중 업로드 이미지 참조 강도.
범위: [0, 1]. 값이 클수록 참조가 강합니다.
human_fidelity
number
얼굴 참조 강도(참조 이미지의 이목구비 유사도).
image_reference가 subject일 때만 적용.
범위: [0, 1]. 값이 클수록 참조가 강합니다.
resolution
string
출력 이미지 해상도.
열거값: 1k, 2k
1k: 1K 표준
2k: 2K HD
n
integer
Required
생성할 이미지 수.
범위: [1, 9]
aspect_ratio
string
출력 화면 비율(가로:세로).
열거값: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9
callback_url
string
작업 완료 시 콜백 URL
Responses
OK
application/json
object
task_id
string
작업 ID
task_status
string
작업 상태