Ana içeriğe atla
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>"
}
Kaynak içeriğin etrafında daha fazla tuvale ihtiyaç duyduğunuzda, bir görüntüyü orijinal sınırlarının ötesine taşırmak için bu endpoint’i kullanın.

Genişletme oranları nasıl çalışır

  • Her oran, orijinal genişlik veya yükseklik esas alınarak ölçülür
  • Birleştirilmiş genişletilmiş tuval yine de Kling’in belgelenmiş alan sınırları içinde kalmalıdır
  • Daha büyük genişletmeleri denemeden önce her bir tarafta 0.1 gibi küçük değerlerle başlayın

Mevcut wrapper durumu

  • Belgelenen route POST /kling/v1/images/editing/expand şeklindedir
  • 2026-03-13 tarihinde yapılan canlı doğrulama, minimum bir istek için {"code": null, "message": "404"} döndürdü
  • Bu endpoint’i belgelenmiş ancak yeniden doğrulanana kadar CometAPI wrapper üzerinde şu anda kullanılamaz olarak değerlendirin
Bu route’u production akışlarına entegre etmeden önce wrapper’ın mevcut kullanılabilirliğini doğrulayın.
Parametrelerin tam referansı için resmi Kling dokümantasyonuna bakın.

Yetkilendirmeler

Authorization
string
header
gerekli

Bearer token authentication. Use your CometAPI key.

Başlıklar

Content-Type
string

Optional content type header.

Gövde

application/json
image
string
varsayılan:https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg
gerekli

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
varsayılan:1
gerekli

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
varsayılan:1
gerekli

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
varsayılan:1
gerekli

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
varsayılan:1
gerekli

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.

Yanıt

Task accepted when the wrapper route is available.

code
integer
gerekli

Error code; specifically define the error code

message
string
gerekli

error message

data
object
gerekli
request_id
string

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