Chuyển đến nội dung chính
POST
/
kling
/
v1
/
images
/
editing
/
expand
Request a Kling image-expansion task
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>"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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

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

  • Mỗi tỷ lệ được tính dựa trên chiều rộng hoặc chiều cao gốc
  • Tổng vùng canvas sau khi mở rộng vẫn phải nằm trong giới hạn diện tích được Kling ghi nhận trong tài liệu
  • 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

​
Tình trạng khả dụng hiện tại

  • Route được ghi trong tài liệu là POST /kling/v1/images/editing/expand
  • Endpoint này trả về phản hồi 404
Hãy xác minh tính khả dụng trước khi tích hợp route này vào các luồng production.
Để xem tài liệu tham chiếu đầy đủ về các tham số, hãy xem tài liệu chính thức của Kling.

Ủ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

Task accepted when the 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
​
request_id
string

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