إنشاء الصور باستخدام Kling
أنشئ الصور باستخدام Kling عبر CometAPI: يدعم POST /kling/v1/images/generations إنشاء الصور بالاعتماد على prompt وإنشاء الصور بالاستناد إلى صورة مرجعية.
إنشاء الصور
الطلب الأول
ابدأ باستخدامmodel_name: kling-v3 وprompt وn وaspect_ratio. أضف الصور المرجعية أو عناصر التحكم في fidelity أو الحقول المتقدمة فقط بعد أن يعيد الطلب الأول مهمة قابلة للاستخدام. يؤدي حذف model_name إلى استخدام إعداد افتراضي قديم للتوافق، لذا أرسل kling-v3 صراحةً في عمليات التكامل الجديدة.
قراءة الاستجابة
احفظtask_id المُعاد، ثم أجرِ poll لمسار استعلام صور Kling المطابق حتى تصل task_status إلى حالة نهائية. إذا كان سير العمل لديك يحتاج إلى تخزين دائم، فانقل الأصل النهائي إلى طبقة التخزين الخاصة بك بعد اكتمال الإنشاء.التفويضات
Bearer token authentication. Use your CometAPI key.
الترويسات
Must be application/json.
الجسم
Text prompt describing the image to generate. Maximum 2500 characters.
Kling image model variant. Use kling-v3 for new requests. Omitting model_name uses the legacy CometAPI route default.
kling-v1, kling-v1-5, kling-v2, kling-v2-1, kling-v3 Elements to exclude from the image. Maximum 2500 characters. Not supported when image is provided.
Reference image as a raw Base64 string without a data: prefix, or a public URL. Accepted formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.
Reference mode for legacy image-to-image requests when image is provided.
subject, face How closely the output follows the reference image. Range: 0-1. Used by legacy image-reference models.
0 <= x <= 1Human-subject fidelity control. Range: 0-1. Used only by legacy subject-reference requests.
0 <= x <= 1Optional Kling element references. The total count of element references and input images must not exceed 10.
Output resolution. Defaults to 1k.
1k, 2k Number of images to generate. Range: 1-9.
1 <= x <= 9Output aspect ratio (width:height).
16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 Watermark options.
Webhook URL to receive task status updates when the task completes.
Optional user-defined task ID for your own tracking. Must be unique per account.