הפרמטרים של GPT Image 2 API: גודל, רזולוציה ורמת איכות

ה-API של GPT Image 2 מקבל את שם המודל ב-model, את ממדי הפלט ב-size כפיקסלים בתבנית WIDTHxHEIGHT, ואת האיכות ב-quality (low, medium, high או auto). אין שדה resolution ואין שדה aspect_ratio. כדי לקבל תמונה ביחס 16:9 ב-4K שולחים "size": "3840x2160". הגדלים חייבים להיות בכפולות של 16, שתי הצלעות חייבות להיות עד 3840 פיקסלים, היחס חייב להישאר בין 1:3 ל-3:1, וסך הפיקסלים חייב להיות בין 655,360 ל-8,294,400.

המדריך הזה עובר על כל פרמטר שמשנה את התמונה, עם הערך המדויק שיש לשלוח והשגיאה שמוחזרת על ערך שגוי. כל שגיאה שלהלן נבדקה מול ה-API החי.

מהו שם המודל של GPT Image 2 ב-API?

השתמש ב-gpt-image-2 או ב-gpt-image-2-official. שניהם אותו מודל עם אותם שדות; gpt-image-2 מחייב מחיר קבוע אחד לכל תמונה שנמסרה, ו-gpt-image-2-official מחייב לפי הטוקנים שכל רינדור מדווח.

שמות מכותרות לא עובדים כמזהי מודל. gpt-image-2.0, GPT Image 2 או chatgpt-images-2 מחזירים כולם HTTP 400 עם קוד השגיאה 20002.

איך מגדירים את הרזולוציה ואת יחס הגובה-רוחב?

עם size, בפיקסלים. בחר את יחס הגובה-רוחב ואת תקציב הפיקסלים שאתה רוצה, ואז שלח את הרוחב והגובה שמתקבלים:

יחס גובה-רוחב	כ-1K	כ-2K	4K
1:1	`1024x1024`	`2048x2048`	`2880x2880`
3:2	`1248x832`	`2496x1664`	`3504x2336`
2:3	`832x1248`	`1664x2496`	`2336x3504`
4:3	`1152x864`	`2304x1728`	`3264x2448`
3:4	`864x1152`	`1728x2304`	`2448x3264`
16:9	`1280x720`	`2560x1440`	`3840x2160`
9:16	`720x1280`	`1440x2560`	`2160x3840`
21:9	`1456x624`	`3024x1296`	`3808x1632`
3:1	`1728x576`	`3504x1168`	`3840x1280`

אלה אותן המרות שה-Playground משתמש בהן כשאתה בוחר יחס וקביעה מוכנה של 1K, 2K או 4K. ריבוע ב-4K נעצר ב-2880x2880, כי ריבוע של 3840 פיקסלים היה חורג ממגבלת סך הפיקסלים.

size: "auto" משאיר את הממדים למודל. זו ברירת המחדל, והיא נוחה, אבל הגדר גודל מפורש כשהפלטים צריכים להתאים לפריסה או זה לזה.

OpenAI מתארת פלט מעל 2560×1440 כניסיוני. הוא מתקבל כאן בתוך המגבלות, אבל קנבס גדול יותר אינו הבטחה ליותר פרטים.

אילו ערכי size נדחים?

הערך שנשלח	למה הוא נכשל	תגובה
`"size": "16:9"`	יחסים אינם גדלים	400 `20001`, ההודעה מציינת `size`
`"size": "4096x2304"`	צלע מעל 3840	400 `20001`, ההודעה מציינת `size`
`"size": "1000x1000"`	לא כפולה של 16	400 `20001`, ההודעה מציינת `size`
`"size": "3840x1024"`	רחב יותר מ-3:1	400 `20001`, ההודעה מציינת `size`
`"resolution": "4k"`	שדה לא מוכר	400 `20001`, בלי שם שדה
`"aspect_ratio": "16:9"`	שדה לא מוכר	400 `20001`, בלי שם שדה

שים לב לשתי השורות האחרונות. שדה לא מוכר נדחה, אבל השגיאה לא מציינת את שמו. אם קיבלת 20001 עם ההודעה הכללית “Check the parameters against the API documentation”, חפש שדה שה-API לא מקבל, כמו resolution, aspect_ratio או response_format.

איזו איכות כדאי לבחור?

quality מקבל low, medium, high ו-auto. דרגות גבוהות יותר לוקחות יותר זמן ומחזיקות פרטים עדינים יותר. xhigh ו-max שייכים ל-GPT Image 2.5 בלבד; שליחה שלהם ל-GPT Image 2 מחזירה 20001 עם הודעה שמציינת את quality.

שגרה מעשית: טיוטות ב-low כל עוד הקומפוזיציה משתנה, בדיקת מרקם וטקסט קטן ב-medium, ותמונות סופיות ב-high. ב-gpt-image-2 המחיר זהה בכל דרגה. ב-gpt-image-2-official דרגות גבוהות יותר מדווחות על יותר טוקני פלט, ולכן עולות יותר. מדריך המחירים מציג את המספרים.

auto נותן למודל לבחור את הדרגה. הגדר ערך מפורש כשאתה משווה בין הרצות, אחרת שתי בקשות "זהות" עלולות להירנדר בדרגות שונות.

מה שולט בפורמט וברקע?

output_format: png (ברירת מחדל) או jpeg. פלט WebP אינו מוצע; webp מחזיר 20001 עם הודעה שמציינת את output_format.
output_compression: 0 עד 100, רק עם jpeg.
background: auto, opaque או transparent. שקיפות דורשת png; transparent עם jpeg מחזיר 20001 עם הודעה שמציינת את background.
n: 1 עד 10 תמונות לבקשה. החיוב הוא על התמונות שנמסרו.
moderation: auto או low.

איך מעבירים תמונות ייחוס ומסכות?

ככתובות URL, אף פעם לא כקבצים או כ-base64. images מקבל 1 עד 16 אובייקטים במבנה {"image_url": "https://..."}, ושליחתו הופכת את הבקשה לעריכה. mask מקבל אובייקט אחד באותו מבנה: קובץ PNG בגודל של תמונת הייחוס הראשונה, שבו האזור השקוף מסמן מה לשנות. התיעוד מפרט את מגבלות הקבצים.

שאלות נפוצות

האם GPT Image 2 תומך ב-4K?

כן, בתוך המגבלות שלמעלה. 3840x2160 ל-16:9 ו-2160x3840 ל-9:16 הם המסגרות הגדולות ביותר, ו-2880x2880 הוא הריבוע הגדול ביותר.

אפשר לשלוח יחס גובה-רוחב במקום פיקסלים?

לא ל-API. המר קודם את היחס לגודל WIDTHxHEIGHT, בעזרת הטבלה שלמעלה או ה-Playground, שמציג את הגודל המדויק לפני השליחה.

מהם גודל ברירת המחדל והאיכות המוגדרת כברירת מחדל?

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

שלח פיקסלים, הגדר את האיכות, קרא את הודעת השגיאה

כמעט כל בעיית פרמטרים היא אחד משלושה דברים: יחס שנשלח כגודל, שדה שה-API לא מקבל, או ערך מחוץ למגבלות. בראשון ובשלישי הודעת השגיאה מציינת את השדה; הודעה כללית שלא מציינת שום שדה מצביעה על השני. החזק את העמוד הזה ליד תיעוד ה-API של GPT Image 2 בזמן האינטגרציה.

הפרמטרים של GPT Image 2 API: גודל, רזולוציה, יחס גובה-רוחב ואיכות