Bild-Erweiterung

Verwenden Sie die Kling Image Expansion API über CometAPI, um Bilder über ihre ursprünglichen Ränder hinaus zu erweitern und dabei den Kontext mit steuerbarer Füllung für videofähige Assets zu bewahren.

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

Verwenden Sie diesen Endpoint, um ein Bild über seine ursprünglichen Ränder hinaus zu erweitern, wenn Sie mehr Arbeitsfläche um den Quellinhalt benötigen.

​

So funktionieren die Erweiterungsverhältnisse

• Jedes Verhältnis wird anhand der ursprünglichen Breite oder Höhe gemessen
• Die insgesamt erweiterte Arbeitsfläche muss weiterhin innerhalb der von Kling dokumentierten Flächenlimits bleiben
• Beginnen Sie mit kleinen Werten wie 0.1 auf jeder Seite, bevor Sie größere Erweiterungen versuchen

​

Aktueller Wrapper-Status

• Die dokumentierte Route ist POST /kling/v1/images/editing/expand
• Eine Live-Validierung am 2026-03-13 ergab {"code": null, "message": "404"} für eine minimale Anfrage
• Behandeln Sie diesen Endpoint als dokumentiert, aber derzeit im CometAPI-Wrapper als nicht verfügbar, bis dies erneut verifiziert wurde

Überprüfen Sie die aktuelle Verfügbarkeit des Wrappers, bevor Sie diese Route in Produktionsabläufe integrieren.

Die vollständige Parameterreferenz finden Sie in der offiziellen Kling-Dokumentation.

Autorisierungen

Authorization · string · header · erforderlich

Bearer token authentication. Use your CometAPI key.

Header

Content-Type · string

Optional content type header.

Body

application/json

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

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 · Standard: 1 · erforderlich

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 · Standard: 1 · erforderlich

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 · Standard: 1 · erforderlich

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 · Standard: 1 · erforderlich

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.

Antwort

200

application/json

Task accepted when the wrapper route is available.

code · integer · erforderlich

Error code; specifically define the error code

message · string · erforderlich

error message

data · object · erforderlich

Show child attributes

request_id · string

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