Skip to main content
POST
cURL
استخدم نقطة النهاية هذه لإنشاء مهمة Kling Omni Image غير متزامنة عبر CometAPI. يعيد طلب الإنشاء task_id؛ استخدم الحصول على مهمة صورة Kling Omni للاستعلام عن المهمة بشكل متكرر حتى تصبح روابط URL للصور المُولدة متاحة.
للاطلاع على المرجع الكامل لمعلمات المزوّد، راجع وثائق Kling Image O1.

اختر شكل الطلب

  • إنشاء صورة واحدة: أرسل 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>>> للعنصر الثاني.

سير المهمة

1

إنشاء المهمة

أرسل POST /kling/v1/images/omni-image واحفظ القيمة المُعادة data.task_id.
2

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

استعلم بشكل متكرر عن GET /kling/v1/images/omni-image/ حتى تصبح data.task_status مساوية لـ succeed أو failed.
3

حفظ الصور

عندما تنجح المهمة، انسخ data.task_result.images[].url إلى مساحة التخزين الخاصة بك إذا كنت تحتاج إلى وصول دائم.
للاطلاع على مخطط الاستجابة الكامل وأمثلة الاستعلام المتكرر، راجع الحصول على مهمة صورة Kling Omni. يوضح المثال المختصر التالي كيفية الاستعلام عن مهمة واحدة بشكل متكرر حتى تصل إلى حالة نهائية:

حقول النتيجة

تعيد استجابات الاستعلام الناجحة الصور المُولدة ضمن data.task_result.images. ويمكن أن يتضمن كل عنصر ما يلي: قد تنتهي صلاحية روابط URL للأصول المُولدة أو قد تتم إزالتها بواسطة خدمة المزوّد. خزّن الصور النهائية في طبقة التخزين الخاصة بك عندما تتطلب سير العمل لديك الاحتفاظ بها لفترة طويلة.

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI API key.

الترويسات

Content-Type
string

Must be application/json.

الجسم

application/json
prompt
string
مطلوب

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.

model_name
string

Optional model ID for this Omni Image request. Omit this field to use the route default.

image_list
object[]

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.

resolution
enum<string>
افتراضي:1k

Requested output resolution. Use 1k, 2k, or 4k; omitted requests use 1k.

الخيارات المتاحة:
1k,
2k,
4k
result_type
enum<string>
افتراضي:single

Use single for a single-image task.

الخيارات المتاحة:
single
n
integer
افتراضي:1

Number of single-image results to generate. Range: 1 to 9.

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

Requested 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_info
object

Watermark options. When enabled is true, the task can return watermarked result URLs in addition to the original result URLs.

callback_url
string<uri>

Webhook URL that receives task status notifications when the task status changes. Omit this field to poll manually.

external_task_id
string

User-defined task ID for your own tracking. It does not replace the system-generated task_id and must be unique per account.

الاستجابة

200 - application/json

Task accepted.

code
integer
مطلوب

Response code. 0 means the task request was accepted.

message
string
مطلوب

Response message.

data
object
مطلوب
request_id
string

Request identifier returned by CometAPI when present.