Expansion d’image

Utilisez l’API Kling Image Expansion via CometAPI pour étendre des images au-delà de leurs bordures d’origine, en préservant le contexte avec un remplissage contrôlable pour des assets prêts pour la vidéo.

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>"
}

Utilisez ce endpoint pour outpaint une image au-delà de ses bordures d’origine lorsque vous avez besoin de plus de surface autour du contenu source.

​

Fonctionnement des ratios d’extension

• Chaque ratio est mesuré par rapport à la largeur ou à la hauteur d’origine
• La surface étendue combinée doit toujours rester dans les limites de surface documentées par Kling
• Commencez par de petites valeurs comme 0.1 de chaque côté avant de tenter des extensions plus importantes

​

Statut actuel du wrapper

• La route documentée est POST /kling/v1/images/editing/expand
• La validation en direct du 2026-03-13 a renvoyé {"code": null, "message": "404"} pour une requête minimale
• Considérez ce endpoint comme documenté mais actuellement indisponible sur le wrapper CometAPI jusqu’à une nouvelle vérification

Vérifiez la disponibilité actuelle du wrapper avant d’intégrer cette route dans des flux de production.

Pour la référence complète des paramètres, consultez la documentation officielle de Kling.

Autorisations

Authorization · string · header · requis

Bearer token authentication. Use your CometAPI key.

En-têtes

Content-Type · string

Optional content type header.

Corps

application/json

image · string · défaut: https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg · requis

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 · défaut: 1 · requis

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 · défaut: 1 · requis

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 · défaut: 1 · requis

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 · défaut: 1 · requis

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.

Réponse

200

application/json

Task accepted when the wrapper route is available.

code · integer · requis

Error code; specifically define the error code

message · string · requis

error message

data · object · requis

Show child attributes

request_id · string

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