Mở rộng hình ảnh

Sử dụng Kling Image Expansion API qua CometAPI để mở rộng hình ảnh vượt ra ngoài viền gốc, giữ nguyên ngữ cảnh với khả năng kiểm soát phần lấp đầy cho các tài nguyên sẵn sàng cho video.

POST /kling/v1/images/editing/expand

Request a Kling image-expansion task

cURL

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
}
'

200

{
  "code": 123,
  "message": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "created_at": 123,
    "updated_at": 123
  },
  "request_id": "<string>"
}

Sử dụng endpoint này để outpaint một hình ảnh vượt ra ngoài các viền gốc khi bạn cần thêm không gian canvas xung quanh nội dung nguồn.

​

Cách hoạt động của các tỷ lệ mở rộng

• Mỗi tỷ lệ được đo dựa trên chiều rộng hoặc chiều cao gốc
• Canvas mở rộng sau khi kết hợp vẫn phải nằm trong các giới hạn diện tích mà Kling đã tài liệu hóa
• Hãy bắt đầu với các giá trị nhỏ như 0.1 cho mỗi phía trước khi thử các mức mở rộng lớn hơn

​

Trạng thái wrapper hiện tại

• Route được tài liệu hóa là POST /kling/v1/images/editing/expand
• Xác thực trực tiếp vào ngày 2026-03-13 đã trả về {"code": null, "message": "404"} cho một request tối thiểu
• Hãy coi endpoint này là đã được tài liệu hóa nhưng hiện chưa khả dụng trên wrapper CometAPI cho đến khi được xác minh lại

Hãy xác minh tình trạng khả dụng hiện tại của wrapper trước khi tích hợp route này vào các luồng production.

Để xem tham chiếu tham số đầy đủ, hãy xem tài liệu Kling chính thức.

Ủy quyền

Authorization · string · header · bắt buộc

Bearer token authentication. Use your CometAPI key.

Tiêu đề

Content-Type · string

Optional content type header.

Nội dung

application/json

image · string · mặc định: https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg · bắt buộc

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.

up_expansion_ratio · number · mặc định: 1 · bắt buộc

Upward expansion as a multiple of the original image height. Range: 0–2. The resulting image area must not exceed 3× the original.

right_expansion_ratio · number · mặc định: 1 · bắt buộc

Rightward expansion as a multiple of the original image width. Range: 0–2. The resulting image area must not exceed 3× the original.

left_expansion_ratio · number · mặc định: 1 · bắt buộc

Leftward expansion as a multiple of the original image width. Range: 0–2. The resulting image area must not exceed 3× the original.

bottom_expansion_ratio · number · mặc định: 1 · bắt buộc

Downward expansion as a multiple of the original image height. Range: 0–2. The resulting image area must not exceed 3× the original.

prompt · string

Optional text prompt to guide the expanded area content. Max 2500 characters.

n · string

Number of expanded images to generate.

callback_url · string

Webhook URL for task status notifications. The server sends a callback when the task status changes.

external_task_id · string

Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

Phản hồi

200

application/json

Task accepted when the wrapper route is available.

code · integer · bắt buộc

Error code; specifically define the error code

message · string · bắt buộc

error message

data · object · bắt buộc

Show child attributes

request_id · string

Request ID, system-generated, for tracking requests, troubleshooting issues