Image
Kling Image 4.0 Long Image
أنشئ صفحات منتجات وتصاميم ويب طويلة بدقة 1K أو 2K باستخدام Kling Image 4.0 Long Image، ثم استطلع حالة المهمة حتى يظهر رابط ملف PNG النهائي.
أرسل طلب JSON إلى POST /v1/images/generations مع معرّف النموذج kling-image-4-0-long-image. احفظ معرّف المهمة الذي يُعاد إليك، ثم استطلع GET /v1/tasks/{id} حتى يكتمل إنشاء ملف PNG الطويل الواحد.
مثال سريع
ينشئ هذا الطلب تصميم صفحة ويب بدقة 1K انطلاقًا من وصف نصي. خزّن مفتاح 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-long-image",
"contents": [
{"type": "prompt", "text": "Design a tall landing page for a specialty coffee roastery with a hero banner, three single-origin bean cards, roasting notes, and store hours."}
],
"settings": {"skill": "webpage", "resolution": "1k"}
}'نقطة النهاية والترويسات
أرسل طلب JSON إلى POST https://api.seedrouter.ai/v1/images/generations مع الترويستين Content-Type: application/json وAuthorization: Bearer YOUR_API_KEY. احتفظ بالمفتاح على خادمك فقط.
المعاملات
| الحقل | النوع | القيم والافتراضيات |
|---|---|---|
model | سلسلة نصية، مطلوب | kling-image-4-0-long-image |
contents | مصفوفة، مطلوب | عنصر prompt واحد مضافًا إليه عناصر الصور المرجعية الخاصة بالوضع. |
contents[].type | سلسلة نصية، مطلوب | prompt، أو refer_image (لوضع ecommerce فقط، مطلوب 1–3)، أو style_refer_image (لوضع webpage فقط، بحد أقصى 1)، أو subject_refer_image (لوضع webpage فقط، بحد أقصى 1). النوع element غير مدعوم. |
contents[].text | سلسلة نصية | مطلوب لعنصر prompt. الحد الأقصى للنص الإنجليزي وحده 166,000 حرف، ولغير الإنجليزي 71,000 حرف. ويجب أن يحقق النص المختلط المعادلة english / 166000 + non_english / 71000 <= 1. |
contents[].url | سلسلة نصية | مطلوب لكل عنصر صورة. رابط HTTP(S) عام لملف JPEG أو PNG لا يتجاوز حجمه 30 MB، وألا يقل كل جانب عن 300 بكسل، وبنسبة أبعاد من 2:5 إلى 5:2. |
contents[].id | سلسلة نصية | معرّف مرجعي فريد اختياري على مستوى جميع عناصر الصور في الطلب. أشر إليه بصيغة @id داخل الوصف. |
settings.skill | سلسلة نصية، مطلوب | ecommerce لصفحات تفاصيل المنتجات أو webpage لتصاميم صفحات الويب. |
settings.length | سلسلة نصية | short (نحو 2–5 أقسام)، أو medium (افتراضي، نحو 6–10 أقسام)، أو long (نحو 11–18 قسمًا). ينطبق على ecommerce فقط ويُهمل في webpage. |
settings.resolution | سلسلة نصية | 1k (افتراضي، عرض 1024 بكسل) أو 2k (عرض 2048 بكسل). يتكيّف الارتفاع مع المحتوى. الدقة 4k غير مدعومة. |
options.watermark_info.enabled | قيمة منطقية | اختياري. القيمة false هي الوحيدة المدعومة. |
صفحة تفاصيل منتج للتجارة الإلكترونية
يتطلّب وضع ecommerce من 1 إلى 3 عناصر refer_image. أشر إلى كل صورة عبر معرّفها id داخل الوصف.
{
"model": "kling-image-4-0-long-image",
"contents": [
{"type": "refer_image", "url": "https://example.com/kettle-front.png", "id": "front"},
{"type": "refer_image", "url": "https://example.com/kettle-spout.jpg", "id": "spout"},
{"type": "prompt", "text": "Build an ecommerce product detail page for the gooseneck kettle in @front with a close-up section highlighting @spout. Include hero visual, temperature control callouts, brewing scenes, and care notes."}
],
"settings": {"skill": "ecommerce", "length": "medium", "resolution": "2k"}
}تصميم صفحة ويب مع مراجع النمط والعنصر الأساسي
يقبل وضع webpage عنصرًا اختياريًا من style_refer_image (بحد أقصى 1) وآخر من subject_refer_image (بحد أقصى 1). احذف settings.length في وضع webpage.
{
"model": "kling-image-4-0-long-image",
"contents": [
{"type": "style_refer_image", "url": "https://example.com/editorial-grid.png", "id": "layout"},
{"type": "subject_refer_image", "url": "https://example.com/watch.jpg", "id": "watch"},
{"type": "prompt", "text": "Design a watch launch webpage matching the typography and grid rhythm of @layout while showcasing @watch across the hero, movement breakdown, and spec table."}
],
"settings": {"skill": "webpage", "resolution": "2k"}
}استرجاع الصورة الطويلة
انسخ قيمة id من استجابة POST إلى TASK_ID واستطلع الحالة حتى تصبح completed أو failed. تستغرق مهام الصور الطويلة عادةً عدة دقائق، وخاصة في تصاميم long مع 2k.
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"عند اكتمال المهمة، اقرأ الرابط من output.data[0].url. يُنتج كل طلب ملف PNG طويلًا مكتملًا واحدًا. وعند دقة 2k قد يتجاوز حجم الصفحات الطويلة 50 MB، لذا اضبط مهلات التنزيل وتحجيم العرض وفقًا لذلك. راجع مرجع المهام ودليل الأخطاء.
الأسعار
يُحتسب لكل طلب مكتمل رسم فئة إخراج واحدة (ecommerce حسب resolution × length، أو webpage حسب resolution) مضافًا إليه رسم صورة مرجعية واحد عن كل صورة إدخال بدءًا من الأولى. لا تُفرض رسوم على الطلب الفاشل. راجع الأسعار الحالية.
الأخطاء ونصائح الاستخدام
تعيد الطلبات غير الصالحة رمز HTTP 400 قبل الفوترة. ومن أكثر أخطاء التحقق شيوعًا: إغفال settings.skill، أو إرسال ecommerce دون 1–3 روابط refer_image، أو خلط refer_image مع وضع webpage، أو طلب 4k، أو تكرار معرّفات المراجع.
حدّد ترتيب الأقسام بدقة داخل وصفك — من اللافتة الرئيسية حتى المواصفات أو التذييل — واقتصر على الحقائق المؤكدة للمنتج ليظل التصميم دقيقًا. يمكنك التجربة في ساحة تجربة Kling Image 4.0 Long Image ومراجعة مخطط OpenAPI.
