Expansión de imagen

Usa la API de Expansión de imagen de Kling a través de CometAPI para expandir imágenes más allá de sus bordes originales, preservando el contexto con un relleno controlable para recursos listos para video.

POST /kling/v1/images/editing/expand

Request a Kling image-expansion task

cURL

curl --request POST \
  --url https://api.cometapi.com/kling/v1/images/editing/expand \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "image": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg",
  "up_expansion_ratio": 0.1,
  "right_expansion_ratio": 0.1,
  "left_expansion_ratio": 0.1,
  "bottom_expansion_ratio": 0.1
}
'

200

{
  "code": 123,
  "message": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "created_at": 123,
    "updated_at": 123
  },
  "request_id": "<string>"
}

Usa este endpoint para hacer outpainting de una imagen más allá de sus bordes originales cuando necesites más lienzo alrededor del contenido fuente.

​

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

​

Estado actual del wrapper

• La ruta documentada es POST /kling/v1/images/editing/expand
• La validación en vivo realizada el 2026-03-13 devolvió {"code": null, "message": "404"} para una solicitud mínima
• Trata este endpoint como documentado pero actualmente no disponible en el wrapper de CometAPI hasta que se verifique nuevamente

Verifica la disponibilidad actual del wrapper antes de integrar esta ruta en flujos de producción.

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

Optional content type header.

Cuerpo

application/json

image · string · predeterminado: https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg · requerido

Source image to expand. Accepts an image URL or raw Base64 string (no data: prefix). Supported formats: JPG, JPEG, PNG. Max 10 MB, minimum 300×300 px, aspect ratio between 1:2.5 and 2.5:1.

up_expansion_ratio · number · predeterminado: 1 · requerido

Upward expansion as a multiple of the original image height. Range: 0–2. The resulting image area must not exceed 3× the original.

right_expansion_ratio · number · predeterminado: 1 · requerido

Rightward expansion as a multiple of the original image width. Range: 0–2. The resulting image area must not exceed 3× the original.

left_expansion_ratio · number · predeterminado: 1 · requerido

Leftward expansion as a multiple of the original image width. Range: 0–2. The resulting image area must not exceed 3× the original.

bottom_expansion_ratio · number · predeterminado: 1 · requerido

Downward expansion as a multiple of the original image height. Range: 0–2. The resulting image area must not exceed 3× the original.

prompt · string

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

n · string

Number of expanded images to generate.

callback_url · string

Webhook URL for task status notifications. The server sends a callback when the task status changes.

external_task_id · string

Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

Respuesta

200

application/json

Task accepted when the wrapper route is available.

code · integer · requerido

Error code; specifically define the error code

message · string · requerido

error message

data · object · requerido

Show child attributes

request_id · string

Request ID, system-generated, for tracking requests, troubleshooting issues