إنشاء مهمة صورة Kling Omni
استخدم CometAPI POST /kling/v1/images/omni-image لإنشاء مهام Kling Omni Image باستخدام مدخلات prompt والصورة المرجعية.
task_id؛ استخدم الحصول على مهمة صورة Kling Omni للاستعلام عن المهمة بشكل متكرر حتى تصبح روابط URL للصور المُولدة متاحة.
اختر شكل الطلب
- إنشاء صورة واحدة: أرسل
promptوimage_listوresolutionوresult_type: singleوnوaspect_ratio - مخرجات بعلامة مائية: أضف
watermark_info.enabled: trueعندما تحتاج إلى رابط URL لنتيجة بعلامة مائية في استجابة الاستعلام - model ID: احذف
model_nameلاستخدام الإعداد الافتراضي للمسار، أو أرسل model ID مُختبَرًا لـ Omni Image مثلkling-image-o1أوkling-v3-omni
image_list التي تحتوي على حقل image. ويمكن أن يشير prompt إليها حسب الفهرس، مثل <<<image_1>>> للعنصر الأول و<<<image_2>>> للعنصر الثاني.
سير المهمة
إنشاء المهمة
POST /kling/v1/images/omni-image واحفظ القيمة المُعادة data.task_id.الاستعلام عن المهمة
data.task_status مساوية لـ succeed أو failed.حفظ الصور
data.task_result.images[].url إلى مساحة التخزين الخاصة بك إذا كنت تحتاج إلى وصول دائم.حقول النتيجة
تعيد استجابات الاستعلام الناجحة الصور المُولدة ضمنdata.task_result.images. ويمكن أن يتضمن كل عنصر ما يلي:
التفويضات
Bearer token authentication. Use your CometAPI API key.
الترويسات
Must be application/json.
الجسم
Text prompt for the generated image. The prompt can reference images with <<<image_1>>>, <<<image_2>>>, and matching indexes from image_list. Maximum length is 2,500 characters.
Optional model ID for this Omni Image request. Omit this field to use the route default.
Reference images that the prompt can cite with <<<image_1>>>, <<<image_2>>>, and so on. Keep the total number of reference images within the provider limits for the selected model.
Requested output resolution. Use 1k, 2k, or 4k; omitted requests use 1k.
1k, 2k, 4k Use single for a single-image task.
single Number of single-image results to generate. Range: 1 to 9.
1 <= x <= 9Requested output aspect ratio in width:height format. Use auto to let the provider choose from the prompt and references.
16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9, auto Watermark options. When enabled is true, the task can return watermarked result URLs in addition to the original result URLs.
Webhook URL that receives task status notifications when the task status changes. Omit this field to poll manually.
User-defined task ID for your own tracking. It does not replace the system-generated task_id and must be unique per account.