الانتقال إلى المحتوى الرئيسي
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>"
}
استخدم نقطة النهاية هذه لتوسيع الصورة خارج حدودها الأصلية عندما تحتاج إلى مساحة إضافية حول المحتوى المصدر.

كيف تعمل نسب التوسيع

  • يتم قياس كل نسبة مقارنة بالعرض أو الارتفاع الأصلي
  • يجب أن تظل مساحة اللوحة الموسعة المجمعة ضمن حدود المساحة الموثقة في Kling
  • ابدأ بقيم صغيرة مثل 0.1 على كل جانب قبل محاولة عمليات توسيع أكبر

الحالة الحالية للغلاف

  • المسار الموثق هو POST /kling/v1/images/editing/expand
  • أعاد التحقق المباشر بتاريخ 2026-03-13 القيمة {"code": null, "message": "404"} لطلب بسيط
  • تعامل مع نقطة النهاية هذه على أنها موثقة ولكنها غير متاحة حاليًا على غلاف CometAPI إلى أن تتم إعادة التحقق منها
تحقق من توفر الغلاف الحالي قبل دمج هذا المسار في تدفقات الإنتاج.
للمرجع الكامل للمعلمات، راجع وثائق Kling الرسمية.

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الترويسات

Content-Type
string

Optional content type header.

الجسم

application/json
image
string
افتراضي:https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg
مطلوب

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
افتراضي:1
مطلوب

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
افتراضي:1
مطلوب

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
افتراضي:1
مطلوب

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
افتراضي:1
مطلوب

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.

الاستجابة

Task accepted when the wrapper route is available.

code
integer
مطلوب

Error code; specifically define the error code

message
string
مطلوب

error message

data
object
مطلوب
request_id
string

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