Skip to main content
POST
cURL
Use este endpoint para fazer outpainting em uma imagem além de suas bordas originais quando você precisar de mais área de canvas ao redor do conteúdo de origem.

Como as proporções de expansão funcionam

  • Cada proporção é medida em relação à largura ou altura original
  • A área expandida combinada ainda deve permanecer dentro dos limites de área documentados do Kling
  • Comece com valores pequenos, como 0.1 em cada lado, antes de tentar expansões maiores

Fluxo da solicitação

  • Envie todos os quatro campos de proporção, usando 0 para qualquer lado que você não queira expandir
  • Salve o task_id retornado
  • Consulte o caminho de consulta de imagem correspondente do Kling até que a tarefa atinja um estado terminal
Para a referência completa dos parâmetros, consulte a documentação oficial do Kling.

Autorizações

Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Cabeçalhos

Content-Type
string
padrão:application/json

Must be application/json.

Corpo

application/json
image
string
obrigatório

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
obrigatório

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

Intervalo necessário: 0 <= x <= 2
down_expansion_ratio
number
obrigatório

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

Intervalo necessário: 0 <= x <= 2
left_expansion_ratio
number
obrigatório

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

Intervalo necessário: 0 <= x <= 2
right_expansion_ratio
number
obrigatório

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

Intervalo necessário: 0 <= x <= 2
prompt
string

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

n
integer
padrão:1

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

Intervalo necessário: 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.

Resposta

200 - application/json

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

code
obrigatório

Response code. 0 means the task request was accepted.

message
string
obrigatório

Response message.

data
object
obrigatório
request_id
string

Request identifier returned when present.