Skip to main content
POST
cURL
Usa este endpoint para hacer outpainting de una imagen más allá de sus bordes originales cuando necesites más lienzo alrededor del contenido de origen.

Cómo funcionan las proporciones de expansión

  • Cada proporción se mide con respecto al ancho o alto original
  • El lienzo expandido combinado debe seguir manteniéndose dentro de los límites de área documentados de Kling
  • Comienza con valores pequeños como 0.1 en cada lado antes de intentar expansiones mayores

Flujo de la solicitud

  • Envía los cuatro campos de proporción, usando 0 para cualquier lado que no quieras expandir
  • Guarda el task_id devuelto
  • Consulta la ruta de consulta de imágenes de Kling correspondiente hasta que la tarea alcance un estado terminal
Para la referencia completa de parámetros, consulta la documentación oficial de Kling.

Autorizaciones

Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI key.

Encabezados

Content-Type
string
predeterminado:application/json

Must be application/json.

Cuerpo

application/json
image
string
requerido

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
requerido

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

Rango requerido: 0 <= x <= 2
down_expansion_ratio
number
requerido

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

Rango requerido: 0 <= x <= 2
left_expansion_ratio
number
requerido

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

Rango requerido: 0 <= x <= 2
right_expansion_ratio
number
requerido

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

Rango requerido: 0 <= x <= 2
prompt
string

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

n
integer
predeterminado:1

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

Rango requerido: 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.

Respuesta

200 - application/json

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

code
requerido

Response code. 0 means the task request was accepted.

message
string
requerido

Response message.

data
object
requerido
request_id
string

Request identifier returned when present.