Midjourney V8.2 API: שליחה ותשאול של משימת תמונה
שלח משימות תמונה של Midjourney V8.2, שמור את המזהה וקבל תוצאות ב-Python. למד על פרמטרים לפי גרסה, פעולות תמונה ומחירים עדכניים.
קריאה כ-Markdownאינטגרציה של ה-API של Midjourney V8.2 דורשת גרסה מפורשת, בקשת תמונה תקינה ודרך לקבל את המשימה שהושלמה. ב-SeedRouter שולחים אל /v1/images/generations, שומרים את מזהה המשימה שהוחזר ומתשאלים את /v1/tasks/{id}. שליחה מוצלחת מאשרת את קבלת המשימה; התמונות מגיעות בתוצאה שהושלמה.
המדריך הזה פועל לפי מפרט הבקשות של SeedRouter. בדיקה בתשלום ב-18 באוקטובר 2026 השלימה בקשת V8.2 Fast ומסרה ארבע תמונות בגודל 1024 × 1024. הדיוקן שלמטה הוא אחת מהן. דף המודל כולל את ה-Playground ואת המחירים העדכניים; תיעוד ה-API מפריד בין קלטים נתמכים לצירופים שעדיין דורשים אימות. [1]
התחל בבקשת API מפורשת ל-Midjourney V8.2
השתמש במזהה המודל המלא, midjourney-v8.2. SeedRouter דורש מודל מפורש; אל תקצר אותו ל-midjourney ואל תסיק אותו מהגדרת חשבון בממשק אחר. תעד את המודל יחד עם הבקשה שנשלחה. [1]
הכן מפתח API בצד השרת ופרומפט קצר עם תוצאה שאפשר לבדוק. התחל בלי תמונות ייחוס או פעולות עם תמונת אב, כדי שהבקשה הראשונה תבדוק את התהליך הבסיסי. הבקשה הבאה יצרה את סדרת הדיוקנאות המוצגת. היא בוחרת Fast ומפעילה את בדיקת התוכן הנוספת:
{
"model": "midjourney-v8.2",
"prompt": "Cinematic portrait of a young woman with freckles and wind-swept auburn hair, wearing a cream cable-knit sweater, laughing on a coastal cliff at golden hour, warm rim light, shallow depth of field, 85mm film photograph",
"speed": "fast",
"nsfw_check": true
}הבקשה המינימלית דורשת רק model ו-prompt; בהשמטת המהירות, ברירת המחדל היא Fast. אם מוסיפים size, יש להשתמש ביחס תמונה כגון "16:9", ולא בהוראת פיקסלים WIDTHxHEIGHT. הגדרה כללית של לקוח תמונות ששולחת 1024x1024, את quality: "high" או n שרירותי אינה מתאימה למפרט המודל הזה. התאם את גוף הבקשה לטבלת השדות של Midjourney במקום להעתיק ללא שינוי הגדרות של מודל אחר.
שלח פעם אחת ותשאל את מזהה המשימה שנשמר
דוגמת ה-Python להורדה משתמשת בספרייה הסטנדרטית, שומרת את המפתח במשתנה סביבה וכותבת את מזהה המשימה שהתקבלה לקובץ מקומי. יש לה פקודות נפרדות לשליחה ולתשאול חוזר. ההפרדה מאפשרת להמשיך קריאה בלי ליצור עבודת תמונה נוספת.
export SEEDROUTER_API_KEY='your-server-side-key'
python3 midjourney-v8-2.py submit request.json --state mj-task.json
python3 midjourney-v8-2.py poll --state mj-task.jsonשמור את בקשת ה-JSON שלמעלה בשם request.json. החלף את המפתח לדוגמה בסוד שלך בסביבה המקומית; אל תכניס אותו לחבילת קוד לדפדפן ואל תבצע לו commit למאגר קוד. לבדיקת פריסה מקומית, הגדר את SEEDROUTER_BASE_URL שבדוגמה לכתובת הבסיס /v1 של אותה פריסה.
הדוגמה מסרבת לדרוס קובץ מצב קיים בזמן השליחה. היא גם אינה חוזרת אוטומטית על POST אחרי כשל בחיבור. אם התשובה אובדת, ייתכן שהאפליקציה לא תדע אם המשימה התקבלה. בדוק את היסטוריית המשימות לפני שתחליט לשלוח שוב.
תשאול חוזר הוא פעולה שונה: הוא קורא משימה שכבר קיימת. הדוגמה נעצרת כשהמשימה הושלמה או נכשלה, ומדווחת על זמן המתנה מוגבל אם היא עדיין בעיבוד. מגבלת המתנה היא תצפית בצד הלקוח, לא ראיה לכך שצריך ליצור את המשימה מחדש.
קרא את מבנה התוצאה של הפעולה
פעולת תמונה שהושלמה מחזירה כתובות בתוך output.data. עבור על המערך במקום להניח שתמיד יש בו ארבע רשומות. יצירת תמונה, בחירת תמונה אחת, תיאור תמונה ושלב קלט לעריכה עשויים להחזיר סוגי פלט שונים.
| שדה בתוצאה | מה האפליקציה צריכה לעשות |
|---|---|
status | להבחין בין משימות בעיבוד, משימות שהושלמו ומשימות שנכשלו |
output.data[].url | להציג או לשמור כל תמונה שנמסרה |
output.grid | לסמן רשת שנמסרה כרשת; קובץ אחד עשוי להכיל כמה אפשרויות תמונה |
output.text | להציג את הטקסט שהוחזר בלי להניח שיש ארבע הצעות או שהן באנגלית |
output.seed | לתעד כשהוא קיים; לא לדרוש אותו בכל תוצאה |
output.awaiting_input | להמשיך בתהליך קלט העריכה המתועד |
התייחס למשימה שנכשלה ככישלון באפליקציה, גם אם בקשת ה-HTTP ששימשה לקריאתה הצליחה. הצלחת HTTP אומרת ששאילתת המצב טופלה; היא אינה אומרת שהתמונה המבוקשת נוצרה.
כאשר output.grid הוא true, כתובת אחת מכילה את הרשת. אל תמציא ממנה ארבע כתובות נפרדות. בחירה בהמשך משתמשת במיקום התמונה ברשת, שמתחיל באחת; מספר הכתובות אינו מספר האפשרויות הזמינות.
הדוגמה מדפיסה את הפלט שהושלם כ-JSON. האפליקציה יכולה להוסיף אחסון, תמונות ממוזערות ובקרות בחירה לתמונות שהוחזרו. שמור את מזהה המשימה לצד התוצאות כדי שפעולה בהמשך תוכל להפנות למשימת האב הנכונה.
תרגם פרמטרים מקוריים בלי להסתיר התנגשויות
האינטגרציה מקבלת שדות מובנים ודגלי פרומפט מקוריים שנתמכים. סדר הקדימות הוא שדות מובנים, אחריהם extra, ואחריהם דגלים בתוך prompt. ערכי אפס ו-false שניתנו במפורש נשמרים.
לדוגמה, פרומפט שמכיל --stylize 700 יחד עם "stylize": 0 משתמש בערך האפס המפורש. זה שימושי כשהממשק שולח בקרה נפרדת, אך עלול להפתיע אפליקציה שמרכיבה פרומפטים ו-JSON במקומות שונים. עדיף מקור אחד לכל הגדרה.
בבקשות SeedRouter V8.2, השדה quality מקבל 0.25, 0.5, 1 או 2 בצירופים תואמים. איכות ו-hd הם קלטים נפרדים: הגדרת איכות אינה בוחרת HD. בדוק את מגבלות הצירופים הנוכחיות לפני הוספת שניהם או בקרות ייחוס נוספות; קלט מתועד אינו מוכיח את השפעתו בכל גרסה. Raw נפרד משניהם; מדריך Raw מסביר את ההבחנה. [1]
שדות JSON לא מוכרים נזרקים באינטגרציה הזו, ואילו דגלים מקוריים לא מוכרים נדחים. אל תראה בקשה שהתקבלה כהוכחה לכך ששדה JSON נוסף ולא קשור שינה את הפלט. בדוק את שמות השדות המתועדים ושמור את גוף הבקשה המדויק שנשלח ברישום הבדיקה.
שמור פעולות המשך קשורות למשימת התמונה שלהן
השתמש ב-parent_task_id של SeedRouter לפעולת המשך. פעולה תלויה נשארת קשורה להקשר הביצוע המקורי. אם ההקשר אינו זמין, הפעולה נכשלת במקום ליצור משימת אב אחרת במקום אחר. משימת האב חייבת להשתייך לאותו חשבון, להשתמש באותו מודל ולהישאר זמינה לפעולה המבוקשת. אינדקסי התמונות הציבוריים מתחילים באחת.
בחירת תמונה והגדלת רזולוציה יצירתית הן פעולות שונות. אין לתאר תוצאת select כשיפור רזולוציה. באותו אופן, וריאציה, רמיקס ו-Edit Model הרשמי של V8.2 הם יכולות נפרדות עם דרישות שונות.
האינטגרציה הנוכחית אינה חושפת את Edit Model החדש כפעולת API מאומתת. אל תחליף אותו בבקשת inpaint ישנה מתוך הנחה שהיא מספקת אותה התנהגות. מדריך העריכה מסביר חלופות זמינות ורצף עריכה במסכה ב-V6.1 שאומת, ותיעוד ה-API מפרט את מגבלות הפעולות שמומשו.
אמוד עבודות במקום לספור תמונות ממוזערות
יצירה שהושלמה היא עבודה אחת לפי מפרט התמחור של האינטגרציה הזו. בחירת תמונה קיימת מתוך רשת אינה יוצרת עבודת יצירה נוספת לחיוב. מעבר לשלב קלט עריכה אינו מוסיף חיוב יצירה שני; פעולת modal הסופית היא השלב המחויב. יצירה של ארבע תמונות אינה בהכרח ארבע עבודות שמחויבות בנפרד. בדיקת V8.2 Draft ב-18 באוקטובר החזירה 24 תמונות בעבודה אחת; מספר התמונות המוחזרות אינו נוסחת תמחור אמינה.
השתמש במחיר הנוכחי של הגרסה, הפעולה, המהירות והמצב שנבחרו. פעולות על תמונת אב עשויות לרשת הגדרות, ולכן המחיר צריך להתבסס על הבקשה האפקטיבית ולא על ברירות מחדל משוערות. דף המודל קורא תעריפים מוגדרים במקום לקבע סכום בדולרים במדריך הזה.
לבדיקת הקבלה שלך, תעד את הבקשה, מזהה המשימה, המצב הסופי, מספר פריטי הפלט והחיוב בפועל בחשבון. הידור מוצלח או בדיקת HTTP מדומה אינם מוכיחים את העובדות האלה בזמן ריצה. SeedRouter אינו מחייב על בקשות שנכשלו.
שאלות נפוצות
אפשר להשתמש באותו מפתח API ב-JavaScript של צד הלקוח?
שמור אותו בשרת. בקש מהדפדפן לקרוא לנקודת קצה מאומתת באפליקציה, שתשלח את הבקשה עם המפתח שבצד השרת.
האם מזהה משימה אומר שהתמונה מוכנה?
לא. קרא את המשימה עד שהיא מדווחת שהושלמה או נכשלה, ואז טפל בתוצאה המתאימה. שמור את המזהה לפני תחילת לולאת התשאול.
האם תום זמן ההמתנה צריך להפעיל יצירה חדשה?
לא אוטומטית. שמור כל מזהה משימה ידוע ובדוק את המשימה הקיימת. תום זמן החיבור או ההמתנה בצד הלקוח אינו מוכיח שהשליחה המקורית נדחתה.
אפשר לשנות גרסה בפעולה עם תמונת אב?
האינטגרציה הזו דורשת אותו מודל כמו במשימת האב. התחל יצירה נפרדת כשתרצה לבדוק גרסה אחרת.
התחל את אינטגרציית ה-API של Midjourney V8.2 עם בקשה מפורשת אחת ומזהה משימה שמור. אמת את הפלט שנמסר ואת החיוב לפני הוספת תמונות ייחוס או שרשרת פעולות תמונה.
מקורות
המפרט וראיות הביצוע נבדקו ב-18 באוקטובר 2026. התמונות המוצגות הן פלט מבדיקות אינטגרציה בתשלום, לא מדד השוואתי כללי למודל.