GPT Image 2.6

צור וערוך תמונות, צור קובצי GIF מונפשים ובקש פלט SVG עם GPT Image 2.6 דרך API התמונות האסינכרוני של SeedRouter.

⁦GPT Image 2.6⁩ מקבל פרומפטים טקסטואליים ותמונות ייחוס אופציונליות. שלח פעם אחת ל-POST /v1/images/generations, שמור את מזהה המשימה ותשאל את GET /v1/tasks/{id} לקבלת התוצאה. הקבצים המוכנים מוחזרים ככתובות ⁦URL⁩.

מזהי מודלים ומחירים

השתמש ב-GET /v1/models כדי לגלות אילו מודלים זמינים למפתח שלך. מזהי ⁦Sunburst⁩ המוגדרים הם gpt-image-2.6-sunburst-official ו-gpt-image-2.6-sunburst. מזהי ⁦Flare⁩, כשהם מופיעים, משתמשים באותו חוזה פרמטרים. מזהה המודל ללא סיומת משתמש בקבוצת ⁦Default⁩ שלו; קבוצות נוספות משתמשות במזהה model:group שמוצג בגילוי.

ראה מחירים עדכניים ו-⁦Playground⁩. מודלים המתומחרים לפי טוקנים מחויבים לפי השימוש בפועל; מודלים המתומחרים לתמונה משתמשים במחיר התמונה שהוגדר. תשובות ⁦SVG⁩ מדווחות בנפרד על טוקני מודל כתיבת הקוד ב-svg_usage, והחיוב הוא לפי מחירו של אותו מודל ב-⁦SeedRouter⁩.

יצירת תמונה

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-sunburst-official",
    "prompt": "A red paper crane on a pale blue table, soft daylight",
    "size": "1024x1024",
    "quality": "low",
    "complexity": "high"
  }'

התשובה מכילה id. תשאל את המזהה הזה במקום לשלוח שוב את בקשת היצירה:

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

בסיום, output.data מכיל אובייקטים עם url. הורד מהכתובת כדי לשמור את פורמט הקובץ המקורי, ובקובצי ⁦GIF⁩ גם כל פריים של ההנפשה. למשימה שנכשלה יש error והיא אינה מחויבת. ראה מצבי משימה ותשאול.

פרמטרים

יש 18 שדות ברמה העליונה. רק model ו-prompt הם חובה. שדות אופציונליים מקבלים null, שמשמעותו כהשמטה. שדות לא מוכרים מושמטים. ערכים נתמכים שאינם תקינים נכשלים באימות לפני יצירת התמונה.

שדה	סוג	ברירת מחדל ומגבלות
`model`	⁦string⁩	חובה; השתמש במזהה שזמין למפתח שלך.
`prompt`	⁦string⁩	חובה, לא ריק, עד 32,000 תווי ⁦Unicode⁩.
`n`	⁦integer⁩	1; טווח 1–10. ⁦SVG⁩ דורש 1.
`size`	⁦string⁩	`auto` או `WIDTHxHEIGHT`. ראה כללי גודל למטה.
`quality`	⁦string⁩	`auto`; גם `low`, `medium`, `high`, `xhigh`, `max`.
`background`	⁦string⁩	`auto`; גם `opaque`, `transparent`. ⁦JPEG⁩ אינו יכול להיות שקוף.
`output_format`	⁦string⁩	`png`; גם `jpeg`, `gif`, `svg`. פלט ⁦WebP⁩ אינו מוצע.
`output_compression`	⁦integer⁩	100 עבור ⁦JPEG⁩; בין 0–100. שלח רק עם `output_format: "jpeg"`.
`moderation`	⁦string⁩	`auto`; גם `low`. ב-⁦Playground⁩ הציבורי `low` נשאר זמין דרך ה-⁦API⁩ בלבד.
`complexity`	⁦string⁩	`high`; גם `low`, `medium`. מאמץ התכנון, ללא תוספת חיוב נפרדת.
`frame_count`	⁦integer⁩	9; טווח 2–16. ⁦GIF⁩ בלבד.
`frame_duration_ms`	⁦integer⁩	200; לפחות 20 אלפיות שנייה, ללא מקסימום. ⁦GIF⁩ בלבד; המקודד מעגל ל-10 אלפיות השנייה הקרובות ביותר ומגביל כל פריים ל-655,350 אלפיות שנייה.
`svg`	⁦object⁩	מושמט. בחירת מודל כתיבת קוד אופציונלית; ראה למטה.
`images`	⁦array⁩	בין 1–16 אובייקטים בצורה `{"image_url":"https://..."}`; מפעיל עריכה.
`mask`	⁦object⁩	`{"image_url":"https://..."}`. דורש `images`; אי אפשר לשלב עם `markup`.
`markup`	⁦object⁩	`{"image_url":"https://..."}`. דורש `images`; אי אפשר לשלב עם `mask`.
`safety_identifier`	⁦string⁩	מזהה קבוע ואופציונלי של משתמש הקצה, עד 128 תווים. ערך לא ריק מקבל עדיפות על `user`.
`user`	⁦string⁩	מזהה אופציונלי מיושן של משתמש הקצה; מושמט מה-⁦Playground⁩ ולעולם אינו מתמלא אוטומטית.

כתובות הייחוס חייבות להשתמש ב-⁦HTTP⁩ או ב-⁦HTTPS⁩ ולא להכיל פרטי גישה. מזהי קבצים, ⁦base64⁩ מוטמע והעלאות ⁦multipart⁩ אינם מתקבלים; העלה קודם קבצים וספק את הכתובות הציבוריות שלהם. הבקשות משתמשות בתשאול משימות אסינכרוני במקום ב-stream או ב-partial_images. החוזה הזה אינו חושף את input_fidelity, את response_format ואת prompt_rewriter.

גודל תמונה

ביצירת ⁦PNG⁩, ⁦JPEG⁩ ותמונת ייחוס ל-⁦SVG⁩, כל מידה חייבת להתחלק ב-16 ולא לעלות על 3840 פיקסלים. סך הפיקסלים חייב להיות 655,360–8,294,400 ויחס הגובה-רוחב חייב להיות בין 1:3 ל-3:1. דוגמאות: 1024x1024, 1536x1024, 2160x3840, 2880x2880.

מידות ⁦GIF⁩ חייבות להיות כפולות חיוביות של 16, או השתמש ב-auto. ל-⁦GIF⁩ יש תקציב פיקסלים כולל נפרד שמשותף למספר הפריימים, למידות הפריימים ול-n; ⁦OpenAI⁩ לא פרסמה את המגבלה המספרית שלו. ⁦GIF⁩ בגודל 512x512 אינו כפוף לכלל מינימום הפיקסלים של תמונה סטטית.

⁦GIF⁩ מונפש

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A red paper crane flapping its wings in a seamless loop on pale blue",
  "output_format": "gif",
  "size": "512x512",
  "quality": "low",
  "frame_count": 4,
  "frame_duration_ms": 200
}

אפשר ליצור ⁦GIF⁩ מפרומפט או לבקש אותו מתמונות ייחוס. אל תשלב אותו עם מסכה או דחיסה. זמינות התצוגה המקדימה עשויה להיות תלויה בגישה למודל שנבחר.

סתירה בתיעוד, נבדקה ב-5 בנובמבר 2026: מדריך יצירת התמונות של ⁦OpenAI⁩ מציין 2–64 פריימים ו-20–2000 אלפיות שנייה, ואומר שנקודת הקצה לעריכה אינה מחזירה ⁦GIF⁩. תיעוד ⁦Images API⁩ מציין 2–16 פריימים, ללא משך מרבי, ומפרט פלט ⁦GIF⁩ בעריכות. בקשות למקור ב-5 בנובמבר 2026 תאמו לתיעוד: 17 פריימים נדחו ופריים של 3,000 אלפיות שנייה התקבל. ה-⁦API⁩ הזה פועל לפי התיעוד.

⁦SVG⁩

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A simple geometric red paper-crane logo, clean editable vector paths",
  "output_format": "svg",
  "n": 1
}

⁦SVG⁩ זמין ליצירה בלבד ודורש n: 1. אל תשלח תמונות, מסכה, סימונים להכוונת עריכה או דחיסה. הקובץ הוא ⁦XML⁩ סטטי בקידוד ⁦UTF-8⁩ המכיל צורות וקטוריות; סקריפטים, משאבים חיצוניים ותמונות רסטר מוטמעות אינם נתמכים.

כשבחירת מודל כתיבת קוד זמינה, הוסף svg: {"model":"YOUR_AUTHOR_MODEL_ID"}. אובייקט svg שמסופק במפורש דורש model לא ריק. אפשר גם להגדיר את svg.reasoning.effort ל-none, ל-minimal, ל-low, ל-medium, ל-high, ל-xhigh או ל-max; המודל שנבחר קובע באילו ערכים הוא תומך. השמט את reasoning כדי להשתמש בברירת המחדל שלו. ⁦OpenAI⁩ אינה מפרסמת רשימת מודלי כתיבת קוד מותרים או ברירת מחדל כללית. אם בחירת מודל אינה זמינה, השמט את כל אובייקט svg.

התוצאה המוכנה עשויה לכלול svg_usage עם model, input_tokens, output_tokens, reasoning_tokens ו-total_tokens. זה נפרד מ-usage של התמונה, ואינו ספירה נוספת של טוקני תמונה.

תמונות ייחוס, מסכה וסימונים להכוונת עריכה

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "Replace the marked background with a pale blue studio backdrop",
  "images": [{"image_url":"https://example.com/reference.png"}],
  "markup": {"image_url":"https://example.com/transparent-markup.png"},
  "output_format": "png",
  "complexity": "low"
}

תמונות ייחוס תומכות ב-⁦PNG⁩, ב-⁦JPEG⁩ וב-⁦WebP⁩, עד 50 ⁦MB⁩ כל אחת. המסכה והסימונים חייבים להיות ⁦PNG⁩ ובמידות תמונת הייחוס הראשונה לאחר תיקון הכיוון. הסימונים חייבים להכיל פיקסלים שקופים; גם קובץ הסימונים וגם תמונת הייחוס הראשונה יכולים להכיל עד 16,777,216 פיקסלים, וקובץ הסימונים יכול להיות עד 50 ⁦MB⁩. אי אפשר לשלב מסכה וסימונים.

שדות התשובה

פלט תמונה שהושלם מכיל created, data: [{url}], וכאשר הם מדווחים, size, quality, background, output_format, usage, svg_usage ו-safety_identifier. usage עשוי להפריד בין טוקני קלט ופלט של טקסט ותמונה וקלט במטמון. הפלט הציבורי אינו כולל בייטים של תמונה ב-⁦base64⁩ או שדות עלות.

סכמת ⁦OpenAPI⁩ · תיעוד היצירה של ⁦OpenAI⁩ · תיעוד העריכה של ⁦OpenAI⁩ · מדריך התמונות של ⁦OpenAI⁩

On this page