FLUX 3 Image Klein

דוגמה מהירה

שלח בקשה לתמונה, שמור את ה-id שהוחזר ותשאל עד שהמשימה תהיה completed או failed. ה-API משתמש במשימות אסינכרוניות ובפלט URL.

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"flux-3-image-klein","prompt":"An amber bottle on pale limestone in soft morning light","resolution":"1k","aspect_ratio":"3:2"}'

נקודת קצה וכותרות

POST https://api.seedrouter.ai/v1/images/generations

שמור את המפתח בשרת. הצלחת HTTP מאשרת משימה, לא שהתמונה מוכנה.

פרמטרים

מתקבלים 11 שדות. רק model ו-prompt נדרשים. השמט שדות אופציונליים לברירות המחדל; null אינו מתקבל.

יחסים: auto, 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21.

ל-Playground מודל קבוע ועשרה פקדי קלט, כולל n הקבוע ל-1. ערכי בטיחות מעל 2 זמינים רק ב-API, למעט מנהלי מערכת.

מצבים ומגבלות

ללא ייחוס נוצרת תמונה מטקסט. ייחוס אחד מאפשר עריכה וכמה מאפשרים שילוב תמונות. ב-auto, עריכה משתמשת ביחס של הייחוס הראשון. יצירה מטקסט בוחרת יחס מהפרומפט וחוזרת ל-1:1 אם לא נקבע. רזולוציית ברירת המחדל היא 1k בכל מצב.

הרמות מציינות היקף משוער: 768sq הוא כ-768 × 768; 1K כ-1 MP; 1.5K כ-2 MP; 2K כ-4 MP; 4K כ-16 MP. בדוק את הקובץ המוחזר למידות בפועל.

נקודה זו אינה מקבלת width, height, מידות פיקסלים ב-size, negative_prompt, guidance, grounding, prompt_upsampling, mask או mask_url. שדות לא מוכרים מחזירים HTTP 400 לפני חיוב. אין פלט WebP, קלט base64, הזרמה או callbacks.

תמונות ייחוס ועריכה אזורית

העלה ייחוסים לכתובת ציבורית לפני השליחה. גוף הבקשה כולל כתובות, לא בתים של קבצים או data URL.

{
  "model": "flux-3-image-klein",
  "prompt": "Use Image 1 as the subject and Image 2 as the setting; match the perspective and light",
  "image_urls": ["https://example.com/subject.png", "https://example.com/setting.png"],
  "aspect_ratio": "auto",
  "resolution": "2k",
  "seed": 0,
  "steps": 16,
  "output_format": "png"
}

החלף את כתובות הדוגמה בתמונות נגישות שלך. יש סדר לייחוסים: ref_image_0 הוא הראשון. הוראות תיבות תוחמות הן חלק ממחרוזת prompt, לא שדה נפרד. הקואורדינטות הן [y1, x1, y2, x2], מנורמלות ל-0–1000. אובייקט פריסה יכול לכלול id, bbox, desc; עריכה יכולה להשתמש ב-id, from, src_bbox, tgt_bbox, desc. קודד את הבקשה כולה כ-JSON כדי להוסיף תווי מילוט נכונים למירכאות בפרומפט.

חיוב

בקשה מוצלחת אחת יוצרת תמונה אחת. הרזולוציה בלבד קובעת מחיר; צעדים, seed, יחס, מספר ייחוסים ופורמט אינם מוסיפים חיוב. יצירה מטקסט ועריכה מתומחרות זהה. בקשות שנכשלו אינן מחויבות. ראה מחירים עדכניים.

תגובת משימה ותשאול

שליחה:

{"id":"task_example","model":"flux-3-image-klein","status":"processing"}

curl https://api.seedrouter.ai/v1/tasks/task_example \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

משימה שהושלמה (כתובת לדוגמה):

{
  "id": "task_example",
  "model": "flux-3-image-klein",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.png"}]}
}

קרא את output.data[0].url. אפשר עד עשר דקות ליצירה, במיוחד ב-4K. תשאול הוא לקריאה בלבד; חריגה מזמן ההמתנה בצד הלקוח אינה הרשאה לבקשה נוספת בתשלום. תגובות ציבוריות אינן כוללות עלויות או יתרות.

שגיאות

שגיאות HTTP משתמשות ב-{"error": {"code": integer, "message": string}}. ראה מדריך השגיאות המשותף. משימה שנכשלה מציגה שגיאה לצד status: "failed". תקן פרמטרים לפני שליחה מחדש ושמור את המזהה לבדיקת בקשה שנשלחה.

טיפים ומדריכים קשורים

תאר בחיוב וציין אזורים או פרטים לשימור. פחות צעדים עשויים לשנות איכות בלי להוזיל מחיר. השווה שינוי אחד בכל פעם.

• FLUX 3 Image Klein Playground
• מדריך הורדה, משקלים ו-ComfyUI
• מחזור חיי משימה