Langsung ke konten utama
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>"
}
Gunakan endpoint ini untuk melakukan outpaint pada gambar melampaui batas aslinya saat Anda memerlukan kanvas yang lebih luas di sekitar konten sumber.

Cara kerja rasio perluasan

  • Setiap rasio diukur terhadap lebar atau tinggi asli
  • Kanvas hasil perluasan gabungan harus tetap berada dalam batas area yang didokumentasikan oleh Kling
  • Mulailah dengan nilai kecil seperti 0.1 di setiap sisi sebelum mencoba perluasan yang lebih besar

Status wrapper saat ini

  • Rute yang didokumentasikan adalah POST /kling/v1/images/editing/expand
  • Validasi langsung pada 2026-03-13 mengembalikan {"code": null, "message": "404"} untuk permintaan minimal
  • Perlakukan endpoint ini sebagai terdokumentasi tetapi saat ini belum tersedia pada wrapper CometAPI sampai diverifikasi ulang
Verifikasi ketersediaan wrapper saat ini sebelum mengintegrasikan rute ini ke alur produksi.
Untuk referensi parameter lengkap, lihat dokumentasi resmi Kling.

Otorisasi

Authorization
string
header
wajib

Bearer token authentication. Use your CometAPI key.

Header

Content-Type
string

Optional content type header.

Body

application/json
image
string
default:https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg
wajib

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
default:1
wajib

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
default:1
wajib

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
default:1
wajib

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
default:1
wajib

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.

Respons

Task accepted when the wrapper route is available.

code
integer
wajib

Error code; specifically define the error code

message
string
wajib

error message

data
object
wajib
request_id
string

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