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

Image

Kling Image 4.0

View Markdown

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

שלחו בקשת JSON אל POST /v1/images/generations עם מזהה המודל kling-image-4-0. שמרו את מזהה המשימה שהוחזר. אותו endpoint מקבל תקצירים המבוססים על טקסט בלבד וגם תקצירים המונחים באמצעות תמונות ייחוס.

דוגמה מהירה

הבקשה הזו יוצרת תמונת סטילס מרובעת אחת ברזולוציית 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 תווים בשפות אחרות. בטקסט מעורב, סכום היחסים בין כל חלק למגבלה המתאימה לו חייב להיות לכל היותר 1.
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. בשימוש רק במצב single.
settings.series_amountמספר שלם או מחרוזתבמצב series: 2–4 תמונות, ברירת המחדל היא 4. במצב single המערכת מתעלמת מהשדה הזה, והוא יכול להיות מספר שלם מ־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 לדוגמה בכתובת 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.