Skip to main content
POST
cURL
Bruk dette endepunktet til å outpaine et bilde utover de opprinnelige kantene når du trenger mer lerretsplass rundt kildeinnholdet.

Hvordan utvidelsesforholdene fungerer

  • Hvert forhold måles mot den opprinnelige bredden eller høyden
  • Det samlede utvidede lerretet må fortsatt holde seg innenfor Klings dokumenterte arealgrenser
  • Start med små verdier som 0.1 på hver side før du prøver større utvidelser

Forespørselsflyt

  • Send alle fire forholdsfeltene, og bruk 0 for enhver side du ikke vil utvide
  • Lagre den returnerte task_id
  • Poll den tilsvarende Kling-bildespørringsstien til oppgaven når en terminal tilstand
For fullstendig parameterreferanse, se den offisielle Kling-dokumentasjonen.

Autorisasjoner

Authorization
string
header
påkrevd

Bearer token authentication. Use your CometAPI key.

Overskrifter

Content-Type
string
standard:application/json

Must be application/json.

Kropp

application/json
image
string
påkrevd

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
påkrevd

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

Nødvendig område: 0 <= x <= 2
down_expansion_ratio
number
påkrevd

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

Nødvendig område: 0 <= x <= 2
left_expansion_ratio
number
påkrevd

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

Nødvendig område: 0 <= x <= 2
right_expansion_ratio
number
påkrevd

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

Nødvendig område: 0 <= x <= 2
prompt
string

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

n
integer
standard:1

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

Nødvendig område: 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.

Svar

200 - application/json

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

code
påkrevd

Response code. 0 means the task request was accepted.

message
string
påkrevd

Response message.

data
object
påkrevd
request_id
string

Request identifier returned when present.

Sist endret 26. juni 2026