API 레퍼런스
통합 가이드
요금 및 결제
이미지 확장
CometAPI를 통해 Kling Image Expansion API를 사용해 원본 경계를 넘어 이미지를 확장하고, 영상 제작에 적합한 에셋을 위해 맥락을 유지하면서 채우기 범위를 제어할 수 있습니다.
curl --request POST \
--url https://api.cometapi.com/kling/v1/images/editing/expand \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"image": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg",
"up_expansion_ratio": 0.1,
"right_expansion_ratio": 0.1,
"left_expansion_ratio": 0.1,
"bottom_expansion_ratio": 0.1
}
'{
"code": 123,
"message": "<string>",
"data": {
"task_id": "<string>",
"task_status": "<string>",
"created_at": 123,
"updated_at": 123
},
"request_id": "<string>"
}확장 비율 작동 방식
- 각 비율은 원본 너비 또는 높이를 기준으로 측정됩니다
- 확장된 전체 캔버스는 여전히 Kling 문서에 명시된 면적 제한 내에 있어야 합니다
- 더 큰 확장을 시도하기 전에 각 방향에
0.1같은 작은 값부터 시작하세요
현재 래퍼 상태
- 문서화된 경로는
POST /kling/v1/images/editing/expand입니다 - 2026-03-13 기준 라이브 검증에서 최소 요청에 대해
{"code": null, "message": "404"}가 반환되었습니다 - 이 엔드포인트는 문서에는 나와 있지만, 다시 검증되기 전까지는 CometAPI 래퍼에서 현재 사용할 수 없는 것으로 간주하세요
인증
Bearer token authentication. Use your CometAPI key.
헤더
Optional content type header.
본문
Source image to expand. Accepts an image URL or raw Base64 string (no data: prefix). Supported formats: JPG, JPEG, PNG. Max 10 MB, minimum 300×300 px, aspect ratio between 1:2.5 and 2.5:1.
Upward expansion as a multiple of the original image height. Range: 0–2. The resulting image area must not exceed 3× the original.
Rightward expansion as a multiple of the original image width. Range: 0–2. The resulting image area must not exceed 3× the original.
Leftward expansion as a multiple of the original image width. Range: 0–2. The resulting image area must not exceed 3× the original.
Downward expansion as a multiple of the original image height. Range: 0–2. The resulting image area must not exceed 3× the original.
Optional text prompt to guide the expanded area content. Max 2500 characters.
Number of expanded images to generate.
Webhook URL for task status notifications. The server sends a callback when the task status changes.
Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.
curl --request POST \
--url https://api.cometapi.com/kling/v1/images/editing/expand \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"image": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg",
"up_expansion_ratio": 0.1,
"right_expansion_ratio": 0.1,
"left_expansion_ratio": 0.1,
"bottom_expansion_ratio": 0.1
}
'{
"code": 123,
"message": "<string>",
"data": {
"task_id": "<string>",
"task_status": "<string>",
"created_at": 123,
"updated_at": 123
},
"request_id": "<string>"
}