Skip to main content
POST
cURL
Gebruik dit endpoint om een afbeelding buiten de oorspronkelijke randen uit te breiden wanneer je meer canvas rond de broninhoud nodig hebt.

Hoe de uitbreidingsverhoudingen werken

  • Elke verhouding wordt gemeten ten opzichte van de oorspronkelijke breedte of hoogte
  • Het gecombineerde uitgebreide canvas moet nog steeds binnen de gedocumenteerde oppervlaktegrenzen van Kling blijven
  • Begin met kleine waarden zoals 0.1 aan elke kant voordat je grotere uitbreidingen probeert

Verloop van de aanvraag

  • Verstuur alle vier de verhoudingsvelden en gebruik 0 voor elke zijde die je niet wilt uitbreiden
  • Sla de geretourneerde task_id op
  • Poll het overeenkomende Kling-pad voor image query totdat de taak een eindstatus bereikt
Raadpleeg voor de volledige parameterreferentie de officiële Kling-documentatie.

Autorisaties

Authorization
string
header
vereist

Bearer token authentication. Use your CometAPI key.

Headers

Content-Type
string
standaard:application/json

Must be application/json.

Body

application/json
image
string
vereist

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
vereist

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

Vereist bereik: 0 <= x <= 2
down_expansion_ratio
number
vereist

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

Vereist bereik: 0 <= x <= 2
left_expansion_ratio
number
vereist

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

Vereist bereik: 0 <= x <= 2
right_expansion_ratio
number
vereist

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

Vereist bereik: 0 <= x <= 2
prompt
string

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

n
integer
standaard:1

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

Vereist bereik: 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
vereist

Response code. 0 means the task request was accepted.

message
string
vereist

Response message.

data
object
vereist
request_id
string

Request identifier returned when present.