Image
Kling Image 4.0
أنشئ صورًا بدقة 2K أو 4K باستخدام Kling Image 4.0. استخدم صورًا مرجعية مسماة، أو أنشئ تنويعات لصورة واحدة أو سلسلة مترابطة، ثم استطلع حالة المهمة حتى تظهر عناوين URL للصور الناتجة.
أرسل طلب JSON إلى POST /v1/images/generations مع معرّف النموذج kling-image-4-0. احفظ معرّف المهمة الذي يُعاد إليك. تقبل نقطة النهاية نفسها أوصافًا نصية فقط وأوصافًا موجّهة بالصور المرجعية.
مثال سريع
ينشئ هذا الطلب صورة ثابتة مربعة واحدة بدقة 2K. خزّن مفتاح API في متغير البيئة SEEDROUTER_API_KEY.
curl https://api.seedrouter.ai/v1/images/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "kling-image-4-0",
"contents": [
{"type": "prompt", "text": "Photograph an amber glass teapot on blue slate, lit through its handle by the morning sun."}
],
"settings": {"resolution": "2k", "aspect_ratio": "1:1"}
}'نقطة النهاية والترويسات
أرسل JSON إلى POST https://api.seedrouter.ai/v1/images/generations مع Content-Type: application/json وAuthorization: Bearer YOUR_API_KEY. احتفظ بالمفتاح على خادمك.
المعلمات
| الحقل | النوع | القيم والقيم الافتراضية |
|---|---|---|
model | سلسلة نصية، مطلوب | kling-image-4-0 |
contents | مصفوفة، مطلوبة | وصف واحد وصفر إلى عشر صور مرجعية. |
contents[].type | سلسلة نصية، مطلوب | prompt أو refer_image. |
contents[].text | سلسلة نصية | مطلوب للوصف. الحد الأقصى للنص الإنجليزي 50,000 حرف، ولغير الإنجليزي 21,000 حرف. في النص المختلط، يجب ألا يتجاوز مجموع النسبتين من الحدين الخاصين بهما واحدًا. |
contents[].url | سلسلة نصية | مطلوب لكل صورة مرجعية. استخدم رابط HTTP(S) متاحًا لملف JPEG أو PNG لا يتجاوز حجمه 30 MB. يجب ألا يقل طول كل جانب عن 300 بكسل، وأن تكون نسبة العرض إلى الارتفاع بين 2:5 و5:2. |
contents[].id | سلسلة نصية | اسم فريد اختياري للصورة المرجعية. اذكر الاسم بصيغة @name في الوصف. |
settings.result_type | سلسلة نصية | single (افتراضي) لإنشاء صور مستقلة، أو series لإنشاء صور مترابطة. |
settings.n | عدد صحيح | 1–9 صور مستقلة. القيمة الافتراضية 1. يُستخدم في الوضع الفردي فقط. |
settings.series_amount | عدد صحيح أو سلسلة نصية | في الوضع المتسلسل، من 2 إلى 4 صور، والقيمة الافتراضية 4. في الوضع الفردي، يتم تجاهل هذا الحقل، ويمكن أن تكون قيمته عددًا صحيحًا من 2 إلى 10 أو السلسلة auto. |
settings.resolution | سلسلة نصية | 2k (افتراضي) أو 4k. |
settings.aspect_ratio | سلسلة نصية | auto (افتراضي)، أو 16:9، أو 9:16، أو 1:1، أو 4:3، أو 3:4، أو 3:2، أو 2:3، أو 21:9. |
options.watermark_info.enabled | قيمة منطقية | اختياري. القيمة الوحيدة المدعومة هي false. |
سلسلة صور انطلاقًا من صورة مرجعية
استبدل عنوان URL في المثال بعنوان عام لصورة منتجك. يطلب هذا المثال ثلاث صور مترابطة. أدرج تعليمات كل إطار في الوصف نفسه.
{
"model": "kling-image-4-0",
"contents": [
{"type": "refer_image", "url": "https://example.com/lamp.jpg", "id": "lamp"},
{"type": "prompt", "text": "Three shots of @lamp in the same studio. Start with a wide view of the workbench, move to the brass shade, then finish on the warm reflection of the bulb in the desk."}
],
"settings": {"result_type": "series", "series_amount": 3, "resolution": "4k", "aspect_ratio": "3:2"}
}استرجاع كل صورة
انسخ id من استجابة POST إلى TASK_ID. استطلع حالة المهمة عبر نقطة النهاية هذه باستخدام المفتاح نفسه حتى تصبح الحالة completed أو failed.
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"عند اكتمال المهمة، اقرأ كل عنوان URL في output.data[].url. قد تُعيد المهمة عدة صور. إذا انقطع التحقق من الحالة، فاستعلم مجددًا باستخدام المعرّف الأصلي. راجع مرجع المهام لمعرفة دورة حياة المهمة، ودليل الأخطاء لمعرفة رموز الأخطاء.
الأسعار
يُحسب المبلغ الإجمالي بضرب عدد الصور الناتجة بالدقة المطلوبة في سعر الإخراج الساري، ثم إضافة رسوم صورة مرجعية واحدة لكل صورة مُدخلة. تكلف أربع صور بدقة 4K مع صورتين مرجعيتين رسوم إخراج أربع صور بدقة 4K ورسوم صورتين مرجعيتين. لا تُفرض رسوم على الطلب الفاشل. راجع الأسعار الحالية.
الأخطاء والنصائح
تؤدي المدخلات غير الصالحة إلى خطأ في الطلب. تحقق من وجود نص الوصف، ومن عدم تكرار معرّفات الصور المرجعية، ومن دعم إعدادات الدقة أو السلسلة. إذا أعاد الاستدعاء الأول معرّف مهمة، فاستعلم عن ذلك المعرّف قبل تقرير ما إذا كان يلزم إرسال طلب آخر.
عند كتابة وصف يعتمد على صور مرجعية متعددة، استخدم اسمًا مميزًا لكل عنصر، ووضّح للنموذج السمات البصرية التي توفرها كل صورة مرجعية. أدرج توجيهات الكاميرا وتسلسل اللقطات في الوصف. راجع ساحة تجربة Kling Image 4.0 ومخطط OpenAPI.
