Skip to main content
POST
cURL
Gunakan endpoint ini untuk melakukan outpaint pada gambar melampaui batas aslinya saat Anda memerlukan kanvas tambahan di sekitar konten sumber.

Cara kerja rasio ekspansi

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

Alur request

  • Kirim keempat field rasio, gunakan 0 untuk sisi mana pun yang tidak ingin Anda perluas
  • Simpan task_id yang dikembalikan
  • Lakukan polling pada path kueri gambar Kling yang sesuai hingga task mencapai status terminal
Untuk referensi parameter lengkap, lihat dokumentasi resmi Kling.

Otorisasi

Authorization
string
header
wajib

Bearer token authentication. Use your CometAPI key.

Header

Content-Type
string
default:application/json

Must be application/json.

Body

application/json
image
string
wajib

Source image to expand. Image URL or raw Base64 string without a data: prefix. Supported formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.

up_expansion_ratio
number
wajib

Upward expansion ratio as a multiple of the original image dimension. Range: 0-2. Send 0 for sides you do not want to expand.

Rentang yang diperlukan: 0 <= x <= 2
down_expansion_ratio
number
wajib

Downward expansion ratio as a multiple of the original image dimension. Range: 0-2. Send 0 for sides you do not want to expand.

Rentang yang diperlukan: 0 <= x <= 2
left_expansion_ratio
number
wajib

Leftward expansion ratio as a multiple of the original image dimension. Range: 0-2. Send 0 for sides you do not want to expand.

Rentang yang diperlukan: 0 <= x <= 2
right_expansion_ratio
number
wajib

Rightward expansion ratio as a multiple of the original image dimension. Range: 0-2. Send 0 for sides you do not want to expand.

Rentang yang diperlukan: 0 <= x <= 2
prompt
string

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

n
integer
default:1

Number of expanded images to generate. Range: 1-9.

Rentang yang diperlukan: 1 <= x <= 9
watermark_info
object

Watermark options.

callback_url
string

Webhook URL for task status notifications.

external_task_id
string

Optional user-defined task ID for your own tracking. Must be unique per account.

Respons

200 - application/json

Task request accepted or an error response returned by the API.

code
wajib

Response code. 0 means the task request was accepted.

message
string
wajib

Response message.

data
object
wajib
request_id
string

Request identifier returned when present.