Zum Hauptinhalt springen
POST
/
kling
/
v1
/
images
/
editing
/
expand
Request a Kling image-expansion task
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
}
'
{
  "code": 123,
  "message": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "created_at": 123,
    "updated_at": 123
  },
  "request_id": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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

​
So funktionieren die Expansionsverhältnisse

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

​
Aktuelle Verfügbarkeit

  • Die dokumentierte Route ist POST /kling/v1/images/editing/expand
  • Dieser Endpoint gibt eine 404-Antwort zurück
Überprüfen Sie die Verfügbarkeit, 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

Task accepted when the route is available.

​
code
integer
erforderlich

Error code; specifically define the error code

​
message
string
erforderlich

error message

​
data
object
erforderlich
​
request_id
string

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