מדריך ל־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 כשאתם מעצבים דף נחיתה למותג, אתר השקה או פריסת תוכן מערכתית. במצב 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 כתובות URL ציבוריות של JPEG/PNG | לא מותר |
style_refer_image / subject_refer_image | לא מותר | אופציונלי: עד 1 מכל סוג |
אף אחד מהמצבים אינו מקבל 4k, מספרי אצווה (n) או יחסי גובה-רוחב. כל משימה שהושלמה מחזירה כתובת URL אחת של קובץ PNG אנכי בתוך output.data[0].url.
הרצה 1: פריסת דף אינטרנט ב־2K מטקסט בלבד (2048 × 16385)

למעלה מוצגים זה לצד זה כל ארבעת הרבעים האנכיים של הרצת ה־webpage ב־2K. הבריף ביקש דף השקה בסגנון תעשייתי שווייצרי בגוון אובסידיאן כהה עבור אוזניות פלנאריות פתוחות בשם 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 הושמט מה־payload הזה, ושמערך 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 ממיר אוטומטית את המזהים השמיים להפניות מיקום, כך שאין צורך לספור אינדקסים ידנית. כל תמונת ייחוס חייבת להיות כתובת URL ציבורית של קובץ 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 בפרומפט. לעולם אל תשכפלו מזהי id באותו מערך contents.
בצעו polling בסבלנות והיערכו להורדות PNG גדולות ב־2K
פריסות אנכיות ארוכות נמשכות זמן רב יותר באופן מוחשי מיצירת פריים יחיד ומחזירות קבצים כבדים בהרבה. התייחסות אליהן כאל API של תמונה ממוזערת לחמש שניות היא הדרך המהירה ביותר לגרום ל־timeout בצד הלקוח או לחיוב כפול בטעות.
בהרצות שלנו מ־19 בנובמבר, דף האינטרנט בגודל 2048 × 16385 הסתיים ב־169 שניות (17 MB), ודף המסחר האלקטרוני הבינוני בגודל 2048 × 19533 הסתיים ב־261 שניות (25 MB). דפי מסחר אלקטרוני ב־2K באורך long עשויים לעבור שבע דקות ולחרוג מ־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 והזרימו אותה לדיסק עם timeout הורדה נדיב:
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בתהליכי backend, הימנעו מקריאת כל קובץ ה־PNG לתוך מאגר זיכרון קטן וקבוע לפני כתיבה לדיסק או לאחסון אובייקטים. הזרימו את גוף תגובת ה־HTTP ישירות לקובץ, בדקו את הממדים שלו לפני חיתוך מקטעים לחנויות מובייל, והמירו תצוגות מקדימות ל־WebP תוך שמירת קובץ ה־PNG הארכיוני להדפסה או לייצוא חיתוכים.
תכנון תקציב לכל שמונה מדרגות הפלט ולתמונות הייחוס
התמחור של Kling Image 4.0 Long Image תלוי בשלוש בחירות: skill (ecommerce מול webpage), length (short, medium או long במצב ecommerce) ו־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 $ |
| ecommerce · 2K · short | 0.2723 $ |
| ecommerce · 1K · medium | 0.4538 $ |
| ecommerce · 2K · medium | 0.5294 $ |
| ecommerce · 1K · long | 0.7563 $ |
| ecommerce · 2K · long | 0.8319 $ |
| webpage · 1K | 0.5294 $ |
| webpage · 2K | 0.5748 $ |
| תמונת ייחוס | 0.003025 $ |
שאלות נפוצות
איך בוחרים בין 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 לפני שמאוטמטים את הצינור שלכם.



