دليل Kling Image 4.0 Long Image
أنشئ تصاميم ويب وصفحات منتجات بدقة 2K مع Kling Image 4.0 Long Image. استعرض تجربتَين فعليتَين بملفات PNG طويلة مع أوامر curl والاستطلاع والأسعار.
اقرأ بصيغة Markdownتنتج نماذج الصور المعتادة إطارًا واحدًا في كل مرة. وحين تطلب منها صفحة تفاصيل منتج أو صفحة إطلاق كاملة، تجد نفسك أمام ست لافتات منفصلة تحاول توحيد هوامشها وخطوطها ومقياس المنتج فيها داخل برنامج تصميم. يعمل Kling Image 4.0 Long Image بطريقة مختلفة تمامًا: طلب API واحد يعيد ملف PNG عموديًا متصلًا من الأعلى إلى الأسفل، بعرض ثابت يبلغ 1K (1024 px) أو 2K (2048 px) وارتفاع يتحدّد تبعًا للأقسام التي تكتبها في وصفك.
في 19 نوفمبر 2026، نفّذنا مهمتَين بدقة 2K عبر نقطة النهاية /v1/images/generations على SeedRouter لاختبار الوضعين بوصفين عمليين حقيقيين. اعتمدت التجربة الأولى وضع webpage بالنص وحده وأعادت صفحة إطلاق بأبعاد 2048 × 16385 بكسل لعلامة سماعات استوديو متخيّلة (17 MB خلال 169 ثانية). أمّا التجربة الثانية فاستخدمت وضع ecommerce بالطول المتوسط medium مع صورتين مرجعيتين للمجوهرات، وأعادت صفحة تفاصيل منتج بأبعاد 2048 × 19533 بكسل (25 MB خلال 261 ثانية). يمكنك معاينة الصفحتين كاملتَين أدناه، أو اختبار أيٍّ من الوصفين داخل ساحة تجربة Kling Image 4.0 Long Image، ومراجعة أسعار كل فئة في الجدول الفوري أسفل المقال.
اختر ecommerce أو webpage قبل كتابة أي سطر
حقل settings.skill إلزامي، وهو يغيّر البنية البصرية للصفحة والمعاملات التي تقبلها واجهة API في آنٍ واحد. تعامل مع الوضعين كعقدَين منفصلَين لا كمجرّد أنماط شكلية.
استخدم ecommerce عندما تملك صورًا حقيقية للمنتج وتحتاج إلى صفحة تفاصيل منتج عمودية (PDP) لمتجر إلكتروني أو سوق رقمي. في وضع ecommerce يجب إرسال عنصر واحد إلى ثلاثة عناصر من نوع refer_image داخل contents، مع ضبط حجم الأقسام العمودية عبر settings.length (short أو medium أو long، والافتراضي medium). وأي طلب دون صور منتج يُرفض قبل الفوترة.
أمّا وضع webpage فمخصّص لتصميم صفحات الهبوط للعلامات التجارية أو صفحات الإطلاق أو التصاميم التحريرية. في هذا الوضع تكون المراجع اختيارية: يمكنك التشغيل بالنص وحده، أو تمرير عنصر واحد كحد أقصى من style_refer_image لتوجيه لوحة الألوان وإيقاع الشبكة، وعنصر واحد كحد أقصى من subject_refer_image لتثبيت عنصر محوري في الصفحة. لا تُرسل refer_image أو settings.length في وضع webpage؛ فكلاهما محصور في طلبات ecommerce وسيؤدي خلطهما إلى خطأ تحقق فوري.
| الإعداد أو المدخل | وضع ecommerce | وضع webpage |
|---|---|---|
settings.skill | "ecommerce" (مطلوب) | "webpage" (مطلوب) |
settings.length | "short" أو "medium" (افتراضي) أو "long" | يُحذف تمامًا |
settings.resolution | "1k" (عرض 1024 px) أو "2k" (عرض 2048 px) | "1k" (عرض 1024 px) أو "2k" (عرض 2048 px) |
عناصر refer_image | مطلوب: 1 إلى 3 روابط JPEG/PNG عامة | غير مسموح |
style_refer_image / subject_refer_image | غير مسموح | اختياري: حتى 1 لكل منهما |
لا يقبل أي من الوضعين دقة 4k أو عدد دفعات (n) أو نسب أبعاد مخصّصة. وكل مهمة ناجحة تُسلّم رابطًا واحدًا فقط لملف PNG طويل داخل output.data[0].url.
التجربة 1: تصميم صفحة ويب بدقة 2K من النص فقط (2048 × 16385)

تعرض الصورة أعلاه الأرباع العمودية الأربعة لنتيجة وضع webpage بدقة 2K مصفوفةً جنبًا إلى جنب. طلب الوصف صفحة إطلاق صناعية سويسرية داكنة بلون الأردواز السبجي لسماعات planar مفتوحة الظهر تحمل اسم S-01 Reference Planar: شريط علوي مختصر، ولقطة رئيسية بزاوية ثلاثة أرباع، وشريط مزايا صوتية من ثلاثة أعمدة، ومقطع عرضي لتشغيل الألمنيوم بتقنية CNC، وجدول مواصفات فنية بأرقام كهربائية حقيقية، وتذييل هادئ.
تأمّل ما حافظ على تماسكه في تمريرة واحدة متصلة. على امتداد 16,385 بكسل عموديًا، بقيت الخلفية الفحمية الداكنة والعناوين التزيينية المذبّبة وهندسة الألمنيوم المصقول متسقة من شريط التنقل العلوي وصولًا إلى شريط الألوان الخمسة وجدول المواصفات. وظهر كل رقم كهربائي مطلوب بوضوح تام (106 mm Iso-Planar و32 Ohms و98 dB/mW و8 Hz–52 kHz و410 g). ومع فحص ملف PNG الكامل بتكبير 100% تبرز ملاحظة عملية صغيرة: طلب الوصف شريطًا فاتحًا بلون المرمر خلف جدول المواصفات، لكن النموذج أبقى الجدول على خلفية داكنة ووضع الشريط الرمادي الفاتح في قسم الاشتراك بالنشرة أسفله. إذا كان تبديل لون خلفية قسم بعينه شرطًا صارمًا في التسليم الهندسي، فتعامل مع المخرج كإخراج فني بصري، ثم قصّ الصور الفوتوغرافية وأعد بناء شريط HTML فوقها.
كتابة وصف قوي لوضع webpage أقرب إلى صياغة مخطط سلكي (wireframe) منها إلى وصف صورة ثابتة. ابدأ بثوابت التصميم العامة (كود الخلفية اللوني، خامة الأسطح، اللون المميّز، انضباط الشبكة)، ثم رقّم كل شريط من الأعلى إلى الأسفل بعناوين وأرقام محددة بالضبط. ترك العناوين عامة يفتح الباب لنصوص حشو غير دقيقة.
curl --fail-with-body -sS 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 vertical flagship product launch webpage for SOLSTICE AUDIO introducing the S-01 Reference Planar open-back studio headphones. Visual language: Swiss minimalist editorial web design, matte obsidian slate (#0E1014), brushed titanium silver surfaces, amber-gold accents, sharp typography. (1) Minimal top bar with wordmark and Reserve button. (2) Hero with headline Silence, Machined. Precision, Amplified. and a three-quarter studio shot of CNC aluminum planar headphones. (3) Three-column highlights for 106 mm Iso-Planar Driver, Zero-Resonance Billet Frame, and Hand-Matched Pairs. (4) Macro exploded machining cutaway. (5) Technical specifications table listing Impedance 32 Ohms, Sensitivity 98 dB/mW, Frequency Response 8 Hz-52 kHz, and Weight 410 g. (6) Minimal studio footer."
}],
"settings": {
"skill": "webpage",
"resolution": "2k"
}
}' -o solstice-task.json
jq -er '.id' solstice-task.jsonلاحظ أن settings.length محذوف من هذا الطلب، وأن contents يضم عنصر prompt وحده. يمكنك مراجعة عقد المعاملات كاملًا في مرجع API لنموذج Kling Image 4.0 Long Image. [1]
التجربة 2: صفحة منتج بدقة 2K بصورتين مرجعيتين (2048 × 19533)

في التجربة الثانية، بدّلنا settings.skill إلى "ecommerce"، وضبطنا settings.length على "medium" مع الإبقاء على resolution عند "2k"، ومرّرنا صورتين حقيقيتين للمجوهرات كعنصرَي refer_image: لقطة ماكرو لقرط أوركيد ذهبي منحوت بالمعرّف id: "earring"، وصورة تحريرية في بيت زجاجي لامرأة ترتدي القرط نفسه بالمعرّف id: "model".
داخل الوصف، أشرنا إلى الأصلين بصيغتي @earring و@model في كل قسم معني. تحوّل واجهة API هذه المعرّفات المسماة إلى مراجع موضعية تلقائيًا دون الحاجة إلى تتبّع الفهارس يدويًا. ويجب أن تكون كل صورة مرجعية رابط JPEG أو PNG عامًا لا يتجاوز 30 MB، وبقياس لا يقل عن 300 px لكل جانب، ونسبة أبعاد بين 2:5 و5:2.

أنتج ذلك الطلب الواحد بطول متوسط ودقة 2K صفحة بارتفاع 19,533 بكسل تغطي ست وحدات تجارة إلكترونية مكتملة: قسم رئيسي على خلفية حرير الشمبانيا، وشريط سردي لإلهام التصميم، وقصّ استوديو نظيف مع جدول معلومات من ستة صفوف (Phalaenopsis No. 4 Drop Earring و18K Recycled Yellow Gold و48 mm drop length وForest-green velvet presentation box)، ولقطة On The Ear وفية تمامًا للصورة @model، وشبكة منتج من ست زوايا (Front وSide وBack وCore Detail وHook Detail وProfile)، وأخيرًا المخطط التوضيحي المشروح Craft And Beauty المقرّب أعلاه.
مع ذلك، كشف الفحص بالدقة الكاملة عن هفوة يجدر الانتباه لها قبل نشر صفحات المنتجات المولّدة مباشرة في متجر حي. فرغم أن جدول المواصفات حافظ على الاسم الدقيق Phalaenopsis No. 4 Drop Earring ووردت كل تسميات المخطط دون أخطاء إملائية، اختصرت اللافتة العلوية عبارة Botanical Series إلى BOTA SERIES وBOTA — Drop Earring بدل طباعة اسم العلامة المطلوب L'ORCHIDÉE. هذا نمط شائع في توليد النصوص داخل الصفحات الطويلة: التسميات القصيرة وصفوف الجداول مستقرة جدًا، بينما قد تنحرف الشعارات الزخرفية المكتوبة بأحرف كبيرة في أعلى الصفحة. افحص دائمًا العنوان الرئيسي بالعرض الكامل، وأضف الشعارات القانونية الدقيقة أو العبارات الإلزامية كطبقات متجهة في قالب متجرك.
curl --fail-with-body -sS 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": "Create a luxury fine-jewelry ecommerce product detail page keeping exact fidelity to the brushed gold orchid earring in @earring and the editorial portrait in @model. Alternate warm champagne silk, alabaster ivory, and dark conservatory tones. (1) Hero product showcase on warm silk. (2) Design inspiration band. (3) Clean product info table listing Phalaenopsis No. 4 Drop Earring, 18K Recycled Yellow Gold, 48 mm drop length, Forest-green velvet presentation box. (4) On-the-ear editorial portrait using @model. (5) Six-angle product detail grid. (6) Annotated Craft And Beauty callout diagram highlighting Hand-Chased Petals, Satin Gold Finish, and Balanced Wire Hook."
},
{
"type": "refer_image",
"id": "earring",
"url": "https://example.com/assets/gold-orchid-earring.png"
},
{
"type": "refer_image",
"id": "model",
"url": "https://example.com/assets/editorial-portrait.png"
}
],
"settings": {
"skill": "ecommerce",
"length": "medium",
"resolution": "2k"
}
}' -o orchidee-task.json
jq -er '.id' orchidee-task.jsonإذا استخدمت صورًا مرجعية في وضع webpage، فتذكّر قاعدة واحدة: مرّر style_refer_image للتوجيه الجمالي وsubject_refer_image للمنتج المحوري، وامنح كلًا منهما معرّف id فريدًا من حروف وأرقام (من 1 إلى 32 حرفًا دون مسافات) ثم أشر إليه بصيغة @id في الوصف، دون تكرار أي معرّف داخل مصفوفة contents نفسها.
استطلع المهمة بصبر وخطّط لتنزيل ملفات 2K PNG الكبيرة
تستغرق الصفحات العمودية الطويلة وقتًا أطول بوضوح من توليد الإطار المفرد، وتعيد ملفات أثقل بكثير. التعامل معها كواجهة صور مصغّرة تستجيب خلال خمس ثوانٍ هو أسرع طريق لانتهاء مهلة العميل أو تكرار الفوترة بالخطأ.
في تجربتَي 19 نوفمبر، اكتملت صفحة الويب بأبعاد 2048 × 16385 خلال 169 ثانية بحجم 17 MB، واكتملت صفحة المتجر المتوسطة بأبعاد 2048 × 19533 خلال 261 ثانية بحجم 25 MB. أمّا صفحات ecommerce الطويلة بدقة 2K فقد تتجاوز سبع دقائق وحجم 50 MB. احفظ معرّف المهمة فور عودة استجابة POST /v1/images/generations، واستطلع GET /v1/tasks/{id} كل 15 إلى 20 ثانية، ولا تعِد إرسال طلب POST ثانٍ لمجرّد انقطاع جلسة الطرفية أو انتهاء مهلة اتصال. [2]
TASK_ID=$(jq -er '.id' orchidee-task.json)
curl --fail-with-body -sS "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" -o orchidee-result.json
jq -r '.status' orchidee-result.jsonعندما تصبح قيمة status هي completed، استخرج رابط ملف PNG الوحيد من output.data[0].url ونزّله مباشرة إلى القرص بمهلة نقل كافية:
IMG_URL=$(jq -er 'select(.status == "completed") | .output.data[0].url' orchidee-result.json)
curl --fail -L --max-time 300 "$IMG_URL" -o orchidee-2k.pngفي الخدمات الخلفية، تجنّب تحميل ملف PNG بالكامل داخل ذاكرة مؤقتة صغيرة ثابتة قبل الحفظ. بثّ جسم استجابة HTTP مباشرة إلى ملف أو تخزين كائنات، وافحص أبعاده قبل قصّ الأقسام لمتاجر الجوال، ثم حوّل نسخ العرض إلى WebP مع الاحتفاظ بملف PNG الأصلي للأرشفة أو التصدير.
تقدير الميزانية عبر الفئات الثماني والصور المرجعية
تعتمد تكلفة Kling Image 4.0 Long Image على ثلاثة اختيارات: skill (ecommerce مقابل webpage)، وlength (short أو medium أو long في وضع التجارة الإلكترونية)، وresolution (1k مقابل 2k). كما تضيف كل صورة مرجعية مُدخلة (refer_image أو style_refer_image أو subject_refer_image) رسم صورة إدخال واحد بدءًا من الصورة الأولى دون حصة مجانية.
يجعل ذلك خطة العمل واضحة جدًا. عند تجريب ترتيب الأقسام وإيقاع العناوين وتدرّج الألوان لكتالوج متجر، ابدأ بمسودة بدقة 1k وطول short أو medium، وراجع التدفق العمودي، ثم انتقل إلى 2k بعد استقرار الوصف. أمّا في تصاميم webpage فالفارق بين 1k و2k محدود بما يكفي لاختيار 2k مبكرًا متى أردت جداول مواصفات دقيقة بخطوط صغيرة واضحة. احتُسبت التجربة الأولى بسعر فئة webpage 2K بالضبط، واحتُسبت التجربة الثانية بسعر فئة ecommerce medium 2K مضافًا إليه رسما صورتَي إدخال. ولا تُفرض رسوم على الطلب الفاشل. راجع الأرقام الفورية أدناه أو أدخل إعداداتك في حاسبة أسعار Kling Image 4.0 Long Image. [3]
تكلفة استخدام Kling Image 4.0 Long Image
| الفئة | الأسعار (USD) |
|---|---|
| ecommerce · 1K · short | 0.2269 US$ |
| ecommerce · 2K · short | 0.2723 US$ |
| ecommerce · 1K · medium | 0.4538 US$ |
| ecommerce · 2K · medium | 0.5294 US$ |
| ecommerce · 1K · long | 0.7563 US$ |
| ecommerce · 2K · long | 0.8319 US$ |
| webpage · 1K | 0.5294 US$ |
| webpage · 2K | 0.5748 US$ |
| صورة مرجعية | 0.003025 US$ |
أسئلة شائعة
كيف أختار بين short وmedium وlong في وضع ecommerce؟
أحصِ الوحدات الفعلية التي يحتاجها منتجك قبل اختيار length. يناسب الطول short ثلاثًا إلى أربع وحدات مركّزة مثل القسم الرئيسي وأبرز المزايا وكتلة مواصفات مختصرة. ويتّسع الطول medium براحة لستة أقسام كما في تجربة المجوهرات أعلاه (قسم رئيسي، وقصة التصميم، ولقطة استوديو مقصوصة، وجدول مواصفات، وصورة استخدام واقعية، وشبكة زوايا متعددة، ومخطط توضيحي). واحتفظ بالطول long للأجهزة التقنية أو المنتجات متعددة الطرازات التي تتطلّب جداول مقارنة وخطوات استخدام وتفاصيل تغليف دون ازدحام النصوص.
لماذا أعاد طلب webpage رمز الخطأ HTTP 400؟
أكثر خطأَي تحقق شيوعًا هما إرسال settings.length مع skill: "webpage"، وتوسيم صورة مرجعية بالنوع type: "refer_image" بدل style_refer_image أو subject_refer_image؛ فكلاهما خاص بوضع ecommerce وحده. تحقّق أيضًا من بقاء الوصف ضمن الحد الموزون للأحرف (en / 166000 + non_en / 71000 <= 1 بعد تحويل إشارات @id) ومن أن resolution مضبوطة على "1k" أو "2k".
هل أقصّ ملف PNG النهائي قبل رفعه إلى متجر حي؟
نعم. ملف PNG بأبعاد 2048 × 19533 يبلغ حجمه من 17 إلى 25 MB غير مضغوط، وهو أثقل بكثير من أن يُعرض داخل وسم <img> واحد على شبكات الجوال. قصّ الصفحة النهائية على حدود الأشرطة الأفقية، واضغط كل شريط بصيغة WebP أو AVIF لتحميل تدريجي سريع، واستبدل العلامات القانونية الحساسة والأسعار وأزرار الشراء بنصوص HTML حقيقية. يمكنك اختبار الأوصاف ومعاينة النتائج بارتفاعها الكامل في ساحة تجربة Kling Image 4.0 Long Image قبل أتمتة مسار عملك.



