Skip to main content
POST
cURL
Usa questo endpoint per applicare outpainting a un’immagine oltre i suoi bordi originali quando hai bisogno di più spazio attorno al contenuto di origine.

Come funzionano i rapporti di espansione

  • Ogni rapporto è misurato rispetto alla larghezza o all’altezza originale
  • L’area totale della tela espansa deve comunque rimanere entro i limiti di area documentati da Kling
  • Inizia con valori piccoli come 0.1 su ciascun lato prima di tentare espansioni più grandi

Flusso della richiesta

  • Invia tutti e quattro i campi ratio, usando 0 per qualsiasi lato che non vuoi espandere
  • Salva il task_id restituito
  • Esegui il polling del percorso di query immagine Kling corrispondente finché il task non raggiunge uno stato terminale
Per il riferimento completo dei parametri, consulta la documentazione ufficiale di Kling.

Autorizzazioni

Authorization
string
header
obbligatorio

Bearer token authentication. Use your CometAPI key.

Intestazioni

Content-Type
string
predefinito:application/json

Must be application/json.

Corpo

application/json
image
string
obbligatorio

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
obbligatorio

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

Intervallo richiesto: 0 <= x <= 2
down_expansion_ratio
number
obbligatorio

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

Intervallo richiesto: 0 <= x <= 2
left_expansion_ratio
number
obbligatorio

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

Intervallo richiesto: 0 <= x <= 2
right_expansion_ratio
number
obbligatorio

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

Intervallo richiesto: 0 <= x <= 2
prompt
string

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

n
integer
predefinito:1

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

Intervallo richiesto: 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.

Risposta

200 - application/json

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

code
obbligatorio

Response code. 0 means the task request was accepted.

message
string
obbligatorio

Response message.

data
object
obbligatorio
request_id
string

Request identifier returned when present.