Skip to main content
POST
cURL
استخدم نقطة النهاية هذه عندما تريد من Kling إنشاء صورة واحدة من عدة مراجع للعنصر، مع مراجع اختيارية للمشهد أو الأسلوب.

قبل استدعائها

  • قدّم من 1 إلى 4 صور في subject_image_list
  • استخدم model_name: kling-v2-1 للطلبات الجديدة
  • أضف scene_image أو style_image فقط عندما يكون التكوين الأساسي للعنصر يعمل بالفعل
  • تعامل مع هذا باعتباره مسار إنشاء غير متزامن واحفظ task id المُعاد

تدفق المهمة

1

إرسال مهمة إنشاء الصورة

أرسل قائمة صور العنصر وPrompt، ثم خزّن task id المُعاد.
2

استطلاع المهمة

استطلِع المهمة المُعادة باستخدام مسار استعلام صور Kling المطابق حتى تصل المهمة إلى حالة نهائية.
3

الاحتفاظ بالنتيجة

احفظ الصورة المُنشأة في مساحة التخزين الخاصة بك إذا كنت بحاجة إلى وصول دائم.
للاطلاع على المرجع الكامل للمعلمات، راجع وثائق Kling الرسمية.

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الترويسات

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

Must be application/json.

الجسم

application/json
subject_image_list
object[]
مطلوب

Subject reference images. Minimum 1, maximum 4.

Required array length: 1 - 4 elements
model_name
enum<string>
افتراضي:kling-v2

Model to use for multi-image generation. Use kling-v2-1 for new requests; omitting the field uses the legacy route default.

الخيارات المتاحة:
kling-v2,
kling-v2-1
prompt
string

Text prompt describing the desired output. Maximum 2500 characters.

negative_prompt
string

Elements to exclude from the image. Maximum 2500 characters.

scene_image
string

Optional scene reference image. 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.

style_image
string

Optional style reference image. 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.

n
integer
افتراضي:1

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

النطاق المطلوب: 1 <= x <= 9
aspect_ratio
enum<string>
افتراضي:16:9

Aspect ratio of the generated image.

الخيارات المتاحة:
16:9,
9:16,
1:1,
4:3,
3:4,
3:2,
2:3,
21: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.