Claude Opus 5.5 כבר זמין ב-SeedRouter

Image

Kling Image 4.0 Long Image

View Markdown

צרו דפי מוצר למסחר אלקטרוני ועיצובי דפי אינטרנט ב־1K או 2K עם Kling Image 4.0 Long Image, ובדקו את הסטטוס עד לקבלת כתובת ה־URL של ה־PNG המוכן.

שלחו בקשת JSON אל POST /v1/images/generations עם מזהה המודל kling-image-4-0-long-image. שמרו את מזהה המשימה שהוחזר, ולאחר מכן בצעו polling אל 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.