이미지 확장
POST
/kling/v1/images/editing/expand
참조 이미지 주변 캔버스를 비율에 맞게 확장하고 확장 결과를 생성합니다.
Authorizations
bearer
Type
HTTP (bearer)
Request Body
application/json
image
string
Required
참조 이미지.
이미지 Base64 인코딩 또는 이미지 URL(접근 가능해야 함)을 지원합니다.
up_expansion_ratio
number
Required
위쪽 확장 범위. 원본 이미지 높이의 배수로 계산합니다.
범위: [0, 2]. 새 이미지 전체 면적은 원본의 3배를 초과할 수 없습니다.
예: 원본 높이 20, 값 0.1 → 원본 상단에서 새 상단까지 20 × 0.1 = 2(확장 영역).
down_expansion_ratio
number
Required
아래쪽 확장 범위. 원본 이미지 높이의 배수로 계산합니다.
범위: [0, 2]. 새 이미지 전체 면적은 원본의 3배를 초과할 수 없습니다.
예: 원본 높이 20, 값 0.2 → 원본 하단에서 새 하단까지 20 × 0.2 = 4(확장 영역).
left_expansion_ratio
number
Required
왼쪽 확장 범위. 원본 이미지 너비의 배수로 계산합니다.
범위: [0, 2]. 새 이미지 전체 면적은 원본의 3배를 초과할 수 없습니다.
예: 원본 너비 30, 값 0.3 → 원본 왼쪽에서 새 왼쪽까지 30 × 0.3 = 9(확장 영역).
right_expansion_ratio
number
Required
오른쪽 확장 범위. 원본 이미지 너비의 배수로 계산합니다.
범위: [0, 2]. 새 이미지 전체 면적은 원본의 3배를 초과할 수 없습니다.
예: 원본 너비 30, 값 0.4 → 원본 오른쪽에서 새 오른쪽까지 30 × 0.4 = 12(확장 영역).
prompt
string
긍정 텍스트 프롬프트.
최대 2500자.
n
integer
Required
생성할 이미지 수.
범위: [1, 9].
callback_url
string
작업 완료 시 콜백 URL
external_task_id
string
외부 작업 ID
Responses
OK
application/json
object
task_id
string
작업 ID
task_status
string
작업 상태