Skip to main content
POST
cURL
استخدم نقطة النهاية هذه لتنفيذ outpaint لصورة خارج حدودها الأصلية عندما تحتاج إلى مساحة إضافية حول المحتوى المصدر.

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

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

تدفق الطلب

  • أرسل حقول النِّسب الأربعة كلها، مع استخدام 0 لأي جانب لا تريد توسيعه
  • احفظ task_id المُعاد
  • نفّذ polling لمسار استعلام صور Kling المطابق حتى تصل المهمة إلى حالة نهائية
للاطلاع على المرجع الكامل للمعلمات، راجع وثائق Kling الرسمية.

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الترويسات

Content-Type
string
افتراضي:application/json

Must be application/json.

الجسم

application/json
image
string
مطلوب

Source image to expand. Image URL or raw Base64 string without a data: prefix. Supported formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.

up_expansion_ratio
number
مطلوب

Upward expansion ratio as a multiple of the original image dimension. Range: 0-2. Send 0 for sides you do not want to expand.

النطاق المطلوب: 0 <= x <= 2
down_expansion_ratio
number
مطلوب

Downward expansion ratio as a multiple of the original image dimension. Range: 0-2. Send 0 for sides you do not want to expand.

النطاق المطلوب: 0 <= x <= 2
left_expansion_ratio
number
مطلوب

Leftward expansion ratio as a multiple of the original image dimension. Range: 0-2. Send 0 for sides you do not want to expand.

النطاق المطلوب: 0 <= x <= 2
right_expansion_ratio
number
مطلوب

Rightward expansion ratio as a multiple of the original image dimension. Range: 0-2. Send 0 for sides you do not want to expand.

النطاق المطلوب: 0 <= x <= 2
prompt
string

Optional text prompt to guide the expanded area content. Maximum 2500 characters.

n
integer
افتراضي:1

Number of expanded images to generate. Range: 1-9.

النطاق المطلوب: 1 <= x <= 9
watermark_info
object

Watermark options.

callback_url
string

Webhook URL for task status notifications.

external_task_id
string

Optional user-defined task ID for your own tracking. Must be unique per account.

الاستجابة

200 - application/json

Task request accepted or an error response returned by the API.

code
مطلوب

Response code. 0 means the task request was accepted.

message
string
مطلوب

Response message.

data
object
مطلوب
request_id
string

Request identifier returned when present.