GPT Image 2.5 Flare הוא מהדורת יצירת התמונות ועריכתן של OpenAI הממוצבת לעבודה יומיומית מהירה ואיכותית. הוא מקבל טקסט ותמונות ומחזיר תוצאות תמונה. השתמשו בו לטיוטות חזותיות, לאיורים, לרעיונות מוצר ולמשימות יצירתיות חוזרות שבהן תדריך צריך להפוך במהירות לתמונה שימושית. Flare נפרד מ־Sunburst, שמיצובו מדגיש דיוק בעריכה. בחרו Flare ליצירת תמונות שגרתית ו־Sunburst כשדיוק העריכה הוא העדיפות.
התחילו בנושא הראשי, בפעולה, בסביבה, בקומפוזיציה ובעיבוד החזותי. לאיור קמפיין, בקשו רוכב אופניים החוצה גשר קטן באור ערב חם, עם צללית בולטת ושמיים פתוחים לטקסט שיוסף בהמשך. תדריך בחינה תמציתי יכול להשאיר בחירות אסתטיות פתוחות; תדריך הפקה צריך לציין את הפרטים והמיקומים החשובים. תהליכי היצירה והעריכה הישירים מאפשרים הנחיות של עד 32,000 תווים ואחת עד עשר תוצאות, ולכן שימושי להשוות כמה גרסאות מול אותה מטרה.
בעריכה אפשר לספק עד שש־עשרה תמונות ייחוס. הקצו לכל ייחוס תפקיד ברור במקום לצפות שהמודל יחליט אם תמונה מייצגת זהות נושא, תפאורה או סגנון. מסכה יכולה להנחות שינוי באזור; עם כמה תמונות היא חלה על הראשונה. התמונה והמסכה זקוקות לפורמט ולמידות תואמים, והמסכה חייבת להכיל ערוץ אלפא. המדריך דורש שהמקור והמסכה יהיו קטנים מ־50 MB. מסכה היא הנחיה ולא הבטחה לשימור גבולות מדויק, לכן ציינו גם את השינוי הרצוי וגם מה צריך להישאר מזוהה.
Flare תומך באיכות low, medium, high, xhigh, max ואוטומטית, עם auto כברירת מחדל. איכות נמוכה יותר יכולה לשמש טיוטה חזותית מהירה; אפשר להשוות הגדרות גבוהות יותר לפרטי תוצר סופי. איכות אינה תלויה בגודל ובדחיסת הפלט. הגדלים הסטנדרטיים כוללים 1024 × 1024, 1536 × 1024 ו־1024 × 1536, ויש גם מידות אוטומטיות או מותאמות. בחרו את הכיוון בהתאם למיקום הסופי ולחלל השימושי בסצנה.
רוחב וגובה מותאמים חייבים להיות כפולות של שש־עשרה, כאשר אף צלע אינה עולה על 3840 פיקסלים. היחס המותר נע מ־1:3 עד 3:1, והשטח הכולל חייב להיות לפחות 655,360 ולכל היותר 8,294,400 פיקסלים. כל ארבעת התנאים חלים יחד. המדריך מזהה רזולוציות מעל 2560 × 1440 כניסיוניות. השתמשו במסגרת תקפה המתאימה לקומפוזיציה, וכללו בתדריך פרטים הרגישים לחיתוך במקום לראות ברזולוציה גדולה יותר שיפור פריסה אוטומטי.
פורמט התוצאה הוא PNG כברירת מחדל, עם חלופות JPEG ו־WebP. JPEG ו־WebP מאפשרים דחיסה מ־0 עד 100. לרקע שקוף, בחרו PNG או WebP; גם רקעים אטומים ואוטומטיים נתמכים. אפשר להציב נכס שקוף בפריסה מאוחרת, בעוד תמונה אטומה כוללת רקע משלה. בחרו פורמט, רקע ודחיסה לפי צורך המסירה בפועל, ושימרו את הקובץ שהושלם עם התדריך וההגדרות שנבחרו.
היצרן מתעד יצירת תמונות ועריכות ישירות, לצד כלי תמונות בשיחה היכול לשמר תוצאות נבחרות לשינויי המשך. בתהליך הזה הפעולה יכולה להיות אוטומטית, יצירה כפויה או עריכה כפויה כאשר תמונה נמצאת בהקשר. הזרמה יכולה להציג עד שלוש תמונות חלקיות לפני התוצאה הסופית. תצוגות אלה מראות התקדמות ואינן תוצרים מוגמרים נוספים. לעבודה איטרטיבית, המשיכו מהתמונה שנבחרה ותארו שינוי נראה, כגון הזזת עצם אחד או התאמת עיבוד הצבע. ממשק היצרן תומך גם בעיבוד באצווה.
בדקו בתמונה כיתוב, מיקום עצמים, פרטי נושא וקומפוזיציה בגודל המיועד. GPT Image עדיין עלול להתקשות במיקום טקסט מדויק, בפריסות מובנות ובזהות חזותית חוזרת בין יצירות. שימרו גרסה שאושרה כייחוס הבא וצמצמו את העריכה הבאה לבעיה החשובה. תפקיד היצירה היומיומית של Flare שימושי לרצף ברור של תדריך, חלופות חזותיות, בחירה וליטוש, כאשר התוצר הסופי נשפט לפי המטרה היצירתית בפועל.
", "aboutText": "GPT Image 2.5 Flare הוא מהדורת יצירת התמונות ועריכתן של OpenAI הממוצבת לעבודה יומיומית מהירה ואיכותית. הוא מקבל טקסט ותמונות ומחזיר תוצאות תמונה. השתמשו בו לטיוטות חזותיות, לאיורים, לרעיונות מוצר ולמשימות יצירתיות חוזרות שבהן תדריך צריך להפוך במהירות לתמונה שימושית. Flare נפרד מ־Sunburst, שמיצובו מדגיש דיוק בעריכה. בחרו Flare ליצירת תמונות שגרתית ו־Sunburst כשדיוק העריכה הוא העדיפות.\n\nהתחילו בנושא הראשי, בפעולה, בסביבה, בקומפוזיציה ובעיבוד החזותי. לאיור קמפיין, בקשו רוכב אופניים החוצה גשר קטן באור ערב חם, עם צללית בולטת ושמיים פתוחים לטקסט שיוסף בהמשך. תדריך בחינה תמציתי יכול להשאיר בחירות אסתטיות פתוחות; תדריך הפקה צריך לציין את הפרטים והמיקומים החשובים. תהליכי היצירה והעריכה הישירים מאפשרים הנחיות של עד 32,000 תווים ואחת עד עשר תוצאות, ולכן שימושי להשוות כמה גרסאות מול אותה מטרה.\n\nבעריכה אפשר לספק עד שש־עשרה תמונות ייחוס. הקצו לכל ייחוס תפקיד ברור במקום לצפות שהמודל יחליט אם תמונה מייצגת זהות נושא, תפאורה או סגנון. מסכה יכולה להנחות שינוי באזור; עם כמה תמונות היא חלה על הראשונה. התמונה והמסכה זקוקות לפורמט ולמידות תואמים, והמסכה חייבת להכיל ערוץ אלפא. המדריך דורש שהמקור והמסכה יהיו קטנים מ־50 MB. מסכה היא הנחיה ולא הבטחה לשימור גבולות מדויק, לכן ציינו גם את השינוי הרצוי וגם מה צריך להישאר מזוהה.\n\nFlare תומך באיכות low, medium, high, xhigh, max ואוטומטית, עם auto כברירת מחדל. איכות נמוכה יותר יכולה לשמש טיוטה חזותית מהירה; אפשר להשוות הגדרות גבוהות יותר לפרטי תוצר סופי. איכות אינה תלויה בגודל ובדחיסת הפלט. הגדלים הסטנדרטיים כוללים 1024 × 1024, 1536 × 1024 ו־1024 × 1536, ויש גם מידות אוטומטיות או מותאמות. בחרו את הכיוון בהתאם למיקום הסופי ולחלל השימושי בסצנה.\n\nרוחב וגובה מותאמים חייבים להיות כפולות של שש־עשרה, כאשר אף צלע אינה עולה על 3840 פיקסלים. היחס המותר נע מ־1:3 עד 3:1, והשטח הכולל חייב להיות לפחות 655,360 ולכל היותר 8,294,400 פיקסלים. כל ארבעת התנאים חלים יחד. המדריך מזהה רזולוציות מעל 2560 × 1440 כניסיוניות. השתמשו במסגרת תקפה המתאימה לקומפוזיציה, וכללו בתדריך פרטים הרגישים לחיתוך במקום לראות ברזולוציה גדולה יותר שיפור פריסה אוטומטי.\n\nפורמט התוצאה הוא PNG כברירת מחדל, עם חלופות JPEG ו־WebP. JPEG ו־WebP מאפשרים דחיסה מ־0 עד 100. לרקע שקוף, בחרו PNG או WebP; גם רקעים אטומים ואוטומטיים נתמכים. אפשר להציב נכס שקוף בפריסה מאוחרת, בעוד תמונה אטומה כוללת רקע משלה. בחרו פורמט, רקע ודחיסה לפי צורך המסירה בפועל, ושימרו את הקובץ שהושלם עם התדריך וההגדרות שנבחרו.\n\nהיצרן מתעד יצירת תמונות ועריכות ישירות, לצד כלי תמונות בשיחה היכול לשמר תוצאות נבחרות לשינויי המשך. בתהליך הזה הפעולה יכולה להיות אוטומטית, יצירה כפויה או עריכה כפויה כאשר תמונה נמצאת בהקשר. הזרמה יכולה להציג עד שלוש תמונות חלקיות לפני התוצאה הסופית. תצוגות אלה מראות התקדמות ואינן תוצרים מוגמרים נוספים. לעבודה איטרטיבית, המשיכו מהתמונה שנבחרה ותארו שינוי נראה, כגון הזזת עצם אחד או התאמת עיבוד הצבע. ממשק היצרן תומך גם בעיבוד באצווה.\n\nבדקו בתמונה כיתוב, מיקום עצמים, פרטי נושא וקומפוזיציה בגודל המיועד. GPT Image עדיין עלול להתקשות במיקום טקסט מדויק, בפריסות מובנות ובזהות חזותית חוזרת בין יצירות. שימרו גרסה שאושרה כייחוס הבא וצמצמו את העריכה הבאה לבעיה החשובה. תפקיד היצירה היומיומית של Flare שימושי לרצף ברור של תדריך, חלופות חזותיות, בחירה וליטוש, כאשר התוצר הסופי נשפט לפי המטרה היצירתית בפועל.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "1312567ad843bc0c46f8a22d24576ba3dd036e746b5a5aadf8c891e7349853f4", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "he", "methods": [ { "html": "gpt-image-2.5-flareGPT Image 2.5 Flare יוצר ועורך תמונות מטקסט ומתמונות ייחוס, בדגש על יצירה חזותית יומיומית מהירה. הוא תומך בגדלים מותאמים, ברקעים שקופים, במסכות וברמות איכות עד max לטיוטות, לאיורים ולחומרי קמפיין.
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
GPT Image 2.5 Flare הוא מהדורת יצירת התמונות ועריכתן של OpenAI הממוצבת לעבודה יומיומית מהירה ואיכותית. הוא מקבל טקסט ותמונות ומחזיר תוצאות תמונה. השתמשו בו לטיוטות חזותיות, לאיורים, לרעיונות מוצר ולמשימות יצירתיות חוזרות שבהן תדריך צריך להפוך במהירות לתמונה שימושית. Flare נפרד מ־Sunburst, שמיצובו מדגיש דיוק בעריכה. בחרו Flare ליצירת תמונות שגרתית ו־Sunburst כשדיוק העריכה הוא העדיפות.
התחילו בנושא הראשי, בפעולה, בסביבה, בקומפוזיציה ובעיבוד החזותי. לאיור קמפיין, בקשו רוכב אופניים החוצה גשר קטן באור ערב חם, עם צללית בולטת ושמיים פתוחים לטקסט שיוסף בהמשך. תדריך בחינה תמציתי יכול להשאיר בחירות אסתטיות פתוחות; תדריך הפקה צריך לציין את הפרטים והמיקומים החשובים. תהליכי היצירה והעריכה הישירים מאפשרים הנחיות של עד 32,000 תווים ואחת עד עשר תוצאות, ולכן שימושי להשוות כמה גרסאות מול אותה מטרה.
בעריכה אפשר לספק עד שש־עשרה תמונות ייחוס. הקצו לכל ייחוס תפקיד ברור במקום לצפות שהמודל יחליט אם תמונה מייצגת זהות נושא, תפאורה או סגנון. מסכה יכולה להנחות שינוי באזור; עם כמה תמונות היא חלה על הראשונה. התמונה והמסכה זקוקות לפורמט ולמידות תואמים, והמסכה חייבת להכיל ערוץ אלפא. המדריך דורש שהמקור והמסכה יהיו קטנים מ־50 MB. מסכה היא הנחיה ולא הבטחה לשימור גבולות מדויק, לכן ציינו גם את השינוי הרצוי וגם מה צריך להישאר מזוהה.
Flare תומך באיכות low, medium, high, xhigh, max ואוטומטית, עם auto כברירת מחדל. איכות נמוכה יותר יכולה לשמש טיוטה חזותית מהירה; אפשר להשוות הגדרות גבוהות יותר לפרטי תוצר סופי. איכות אינה תלויה בגודל ובדחיסת הפלט. הגדלים הסטנדרטיים כוללים 1024 × 1024, 1536 × 1024 ו־1024 × 1536, ויש גם מידות אוטומטיות או מותאמות. בחרו את הכיוון בהתאם למיקום הסופי ולחלל השימושי בסצנה.
רוחב וגובה מותאמים חייבים להיות כפולות של שש־עשרה, כאשר אף צלע אינה עולה על 3840 פיקסלים. היחס המותר נע מ־1:3 עד 3:1, והשטח הכולל חייב להיות לפחות 655,360 ולכל היותר 8,294,400 פיקסלים. כל ארבעת התנאים חלים יחד. המדריך מזהה רזולוציות מעל 2560 × 1440 כניסיוניות. השתמשו במסגרת תקפה המתאימה לקומפוזיציה, וכללו בתדריך פרטים הרגישים לחיתוך במקום לראות ברזולוציה גדולה יותר שיפור פריסה אוטומטי.
פורמט התוצאה הוא PNG כברירת מחדל, עם חלופות JPEG ו־WebP. JPEG ו־WebP מאפשרים דחיסה מ־0 עד 100. לרקע שקוף, בחרו PNG או WebP; גם רקעים אטומים ואוטומטיים נתמכים. אפשר להציב נכס שקוף בפריסה מאוחרת, בעוד תמונה אטומה כוללת רקע משלה. בחרו פורמט, רקע ודחיסה לפי צורך המסירה בפועל, ושימרו את הקובץ שהושלם עם התדריך וההגדרות שנבחרו.
היצרן מתעד יצירת תמונות ועריכות ישירות, לצד כלי תמונות בשיחה היכול לשמר תוצאות נבחרות לשינויי המשך. בתהליך הזה הפעולה יכולה להיות אוטומטית, יצירה כפויה או עריכה כפויה כאשר תמונה נמצאת בהקשר. הזרמה יכולה להציג עד שלוש תמונות חלקיות לפני התוצאה הסופית. תצוגות אלה מראות התקדמות ואינן תוצרים מוגמרים נוספים. לעבודה איטרטיבית, המשיכו מהתמונה שנבחרה ותארו שינוי נראה, כגון הזזת עצם אחד או התאמת עיבוד הצבע. ממשק היצרן תומך גם בעיבוד באצווה.
בדקו בתמונה כיתוב, מיקום עצמים, פרטי נושא וקומפוזיציה בגודל המיועד. GPT Image עדיין עלול להתקשות במיקום טקסט מדויק, בפריסות מובנות ובזהות חזותית חוזרת בין יצירות. שימרו גרסה שאושרה כייחוס הבא וצמצמו את העריכה הבאה לבעיה החשובה. תפקיד היצירה היומיומית של Flare שימושי לרצף ברור של תדריך, חלופות חזותיות, בחירה וליטוש, כאשר התוצר הסופי נשפט לפי המטרה היצירתית בפועל.
POST /v1/images/generationstextimage| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות gpt-image-2.5-flare | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות אורך מזערי: 1 | ברירת מחדל— |
שדהn | סוגinteger | דרישהרשות | ערכים ומגבלות מינימום: 1 | ברירת מחדל1 |
שדהresponse_format | סוגstring | דרישהרשות | ערכים ומגבלות url, b64_json | ברירת מחדל— |
שדהstream | סוגboolean | דרישהרשות | ערכים ומגבלות | ברירת מחדלfalse |
שדהsize | סוגstring | דרישהרשות | ערכים ומגבלות תלוי במודל | ברירת מחדל— |
שדהquality | סוגstring | דרישהרשות | ערכים ומגבלות תלוי במודל | ברירת מחדל— |
שדהbackground | סוגstring | דרישהרשות | ערכים ומגבלות תלוי במודל | ברירת מחדל— |
שדהoutput_format | סוגstring | דרישהרשות | ערכים ומגבלות תלוי במודל | ברירת מחדל— |
שדהoutput_compression | סוגinteger | דרישהרשות | ערכים ומגבלות תלוי במודל | ברירת מחדל— |
שדהmoderation | סוגstring | דרישהרשות | ערכים ומגבלות תלוי במודל | ברירת מחדל— |
שדהinput_fidelity | סוגstring | דרישהרשות | ערכים ומגבלות תלוי במודל | ברירת מחדל— |
שדהstyle | סוגstring | דרישהרשות | ערכים ומגבלות תלוי במודל | ברירת מחדל— |
שדהpartial_images | סוגinteger | דרישהרשות | ערכים ומגבלות תלוי במודל | ברירת מחדל— |
מטקסט לתמונה · נדרש: prompt
| פרמטר | מפרט |
|---|---|
פרמטרmaterial_types | מפרטtext |
פרמטרrequired | מפרטmodel, prompt |
פרמטרoptional_controls | מפרטnull |
פרמטרcontent_type | מפרטapplication/json |
מחזור חיים: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · ערך task_id שהוחזר בפועל או רשומה בספריית המדיה
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
מבני המתודות והמזהים מדויקים; יכולת הספק נפרדת מקבלת הבקשה לביצוע.
POST /v1/images/generationsלפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "gpt-image-2.5-flare", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nfrom openai import OpenAI\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'gpt-image-2.5-flare', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "gpt-image-2.5-flare", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\nהורידו כל תמונה שהוחזרה או שמרו את תוכן ה-Base64 שלה
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}שמרו כל תמונה שהושלמה; אחזרו אותה מכל URL שהוחזר או פענחו את תוכן ה-Base64 שלה.
שמרו כל פריט נתונים. פענחו כל b64_json או הורידו את התוכן מכל URL חתום שהוחזר. בחרו סיומת קובץ לפי סוג ה־MIME/הבתים בפועל.
אם תוצאה של יצירת תמונה או עריכתה דורשת בדיקה, שמרו את operation_id/X-Client-Request-ID המקורי ואת פרטי התוצאה שהוחזרו. שחזרו תוצאות קיימות שבבעלותכם דרך ספריית המדיה באמצעות ערכי task_id או asset_id בפועל. אל תשלחו שוב את בקשת היצירה/העריכה ואל תבנו URL לתשאול סטטוס מתוך operation_id.
| שדה | סוג |
|---|---|
שדהcreated | סוגinteger |
שדהdata[].url | סוגstring |
שדהdata[].b64_json | סוגbase64 string |
שדהusage | סוגobject |
| תגובה | תנאי | השלב הבא |
|---|---|---|
תגובה400 · invalid_request_error | תנאישדות נדרשים, ייצוג חומר או ערך פרמטר שאינם תקינים | השלב הבאתקנו את השדות שצוינו לפני בקשת יצירה חדשה. |
תגובהserver_error | תנאיהתשובה שהוחזרה מציינת שהפעולה או התוצאה דורשת בדיקה | השלב הבאשמרו את מזהה הפעולה/המשימה המקורי שהוחזר, את כותרות הבקשה ואת התשובה; המשיכו לבצע פעולות קריאה נתמכות של אותה פעולה מקורית. אל תשלחו שוב את בקשת היצירה. |
Ailoot gpt-image-2.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare
/v1/images
openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare
gpt-image-2.5-flareGPT Image 2.5 Flare יוצר ועורך תמונות מטקסט ומתמונות ייחוס, בדגש על יצירה חזותית יומיומית מהירה. הוא תומך בגדלים מותאמים, ברקעים שקופים, במסכות וברמות איכות עד max לטיוטות, לאיורים ולחומרי קמפיין.
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
GPT Image 2.5 Flare הוא מהדורת יצירת התמונות ועריכתן של OpenAI הממוצבת לעבודה יומיומית מהירה ואיכותית. הוא מקבל טקסט ותמונות ומחזיר תוצאות תמונה. השתמשו בו לטיוטות חזותיות, לאיורים, לרעיונות מוצר ולמשימות יצירתיות חוזרות שבהן תדריך צריך להפוך במהירות לתמונה שימושית. Flare נפרד מ־Sunburst, שמיצובו מדגיש דיוק בעריכה. בחרו Flare ליצירת תמונות שגרתית ו־Sunburst כשדיוק העריכה הוא העדיפות.
התחילו בנושא הראשי, בפעולה, בסביבה, בקומפוזיציה ובעיבוד החזותי. לאיור קמפיין, בקשו רוכב אופניים החוצה גשר קטן באור ערב חם, עם צללית בולטת ושמיים פתוחים לטקסט שיוסף בהמשך. תדריך בחינה תמציתי יכול להשאיר בחירות אסתטיות פתוחות; תדריך הפקה צריך לציין את הפרטים והמיקומים החשובים. תהליכי היצירה והעריכה הישירים מאפשרים הנחיות של עד 32,000 תווים ואחת עד עשר תוצאות, ולכן שימושי להשוות כמה גרסאות מול אותה מטרה.
בעריכה אפשר לספק עד שש־עשרה תמונות ייחוס. הקצו לכל ייחוס תפקיד ברור במקום לצפות שהמודל יחליט אם תמונה מייצגת זהות נושא, תפאורה או סגנון. מסכה יכולה להנחות שינוי באזור; עם כמה תמונות היא חלה על הראשונה. התמונה והמסכה זקוקות לפורמט ולמידות תואמים, והמסכה חייבת להכיל ערוץ אלפא. המדריך דורש שהמקור והמסכה יהיו קטנים מ־50 MB. מסכה היא הנחיה ולא הבטחה לשימור גבולות מדויק, לכן ציינו גם את השינוי הרצוי וגם מה צריך להישאר מזוהה.
Flare תומך באיכות low, medium, high, xhigh, max ואוטומטית, עם auto כברירת מחדל. איכות נמוכה יותר יכולה לשמש טיוטה חזותית מהירה; אפשר להשוות הגדרות גבוהות יותר לפרטי תוצר סופי. איכות אינה תלויה בגודל ובדחיסת הפלט. הגדלים הסטנדרטיים כוללים 1024 × 1024, 1536 × 1024 ו־1024 × 1536, ויש גם מידות אוטומטיות או מותאמות. בחרו את הכיוון בהתאם למיקום הסופי ולחלל השימושי בסצנה.
רוחב וגובה מותאמים חייבים להיות כפולות של שש־עשרה, כאשר אף צלע אינה עולה על 3840 פיקסלים. היחס המותר נע מ־1:3 עד 3:1, והשטח הכולל חייב להיות לפחות 655,360 ולכל היותר 8,294,400 פיקסלים. כל ארבעת התנאים חלים יחד. המדריך מזהה רזולוציות מעל 2560 × 1440 כניסיוניות. השתמשו במסגרת תקפה המתאימה לקומפוזיציה, וכללו בתדריך פרטים הרגישים לחיתוך במקום לראות ברזולוציה גדולה יותר שיפור פריסה אוטומטי.
פורמט התוצאה הוא PNG כברירת מחדל, עם חלופות JPEG ו־WebP. JPEG ו־WebP מאפשרים דחיסה מ־0 עד 100. לרקע שקוף, בחרו PNG או WebP; גם רקעים אטומים ואוטומטיים נתמכים. אפשר להציב נכס שקוף בפריסה מאוחרת, בעוד תמונה אטומה כוללת רקע משלה. בחרו פורמט, רקע ודחיסה לפי צורך המסירה בפועל, ושימרו את הקובץ שהושלם עם התדריך וההגדרות שנבחרו.
היצרן מתעד יצירת תמונות ועריכות ישירות, לצד כלי תמונות בשיחה היכול לשמר תוצאות נבחרות לשינויי המשך. בתהליך הזה הפעולה יכולה להיות אוטומטית, יצירה כפויה או עריכה כפויה כאשר תמונה נמצאת בהקשר. הזרמה יכולה להציג עד שלוש תמונות חלקיות לפני התוצאה הסופית. תצוגות אלה מראות התקדמות ואינן תוצרים מוגמרים נוספים. לעבודה איטרטיבית, המשיכו מהתמונה שנבחרה ותארו שינוי נראה, כגון הזזת עצם אחד או התאמת עיבוד הצבע. ממשק היצרן תומך גם בעיבוד באצווה.
בדקו בתמונה כיתוב, מיקום עצמים, פרטי נושא וקומפוזיציה בגודל המיועד. GPT Image עדיין עלול להתקשות במיקום טקסט מדויק, בפריסות מובנות ובזהות חזותית חוזרת בין יצירות. שימרו גרסה שאושרה כייחוס הבא וצמצמו את העריכה הבאה לבעיה החשובה. תפקיד היצירה היומיומית של Flare שימושי לרצף ברור של תדריך, חלופות חזותיות, בחירה וליטוש, כאשר התוצר הסופי נשפט לפי המטרה היצירתית בפועל.
POST /v1/images/generationstextimage| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות gpt-image-2.5-flare | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות אורך מרבי: 32,000 | ברירת מחדל— |
שדהsize | סוגstring | דרישהרשות | ערכים ומגבלות תנאים: יש להשתמש ב־auto או ב־WIDTHxHEIGHT, כששני הממדים מתחלקים ב־16. אורך הצלע הארוכה הוא לכל היותר 3,840 פיקסלים, והגודל הכולל הוא לכל היותר 8,300,000 פיקסלים. | ברירת מחדלauto |
שדהbackground | סוגstring | דרישהרשות | ערכים ומגבלות transparent, opaque, auto | ברירת מחדלauto |
שדהmoderation | סוגstring | דרישהרשות | ערכים ומגבלות low, auto תנאים: יש להשתמש ב־auto לבדיקת תוכן רגילה. | ברירת מחדל— |
שדהn | סוגinteger | דרישהרשות | ערכים ומגבלות מינימום: 1 מקסימום: 10 | ברירת מחדל1 |
שדהquality | סוגstring | דרישהרשות | ערכים ומגבלות auto, high, medium, low | ברירת מחדלauto |
שדהoutput_compression | סוגinteger | דרישהרשות | ערכים ומגבלות מינימום: 0 מקסימום: 100 תנאים: חל על פלט JPEG ו־WebP; יש לשלוח את הערך השלם המתועד. | ברירת מחדל100 |
שדהoutput_format | סוגstring | דרישהרשות | ערכים ומגבלות webp, png, jpeg | ברירת מחדלpng |
שדהstream | סוגboolean | דרישהרשות | ערכים ומגבלות false תנאים: הנתיב הזה מחזיר תגובת JSON שלמה אחת. | ברירת מחדלfalse |
| פרמטר | מפרט |
|---|---|
פרמטרcontent_type | מפרטapplication/json |
פרמטרrequired | מפרטprompt, model |
פרמטרmaterial_types | מפרטtext |
פרמטרoptional | מפרטsize, background, moderation, n, quality, output_compression, output_format, stream |
פרמטרconditions | מפרטרקע שקוף מחייב PNG או WebP., דחיסת הפלט חלה על JPEG או WebP., השיטה שנבחרה יוצרת מטקסט. אפשרויות העריכה וההזרמה המתוארות אצל היצרן הן יכולות נפרדות. |
מחזור חיים: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · ערך task_id שהוחזר בפועל או רשומה בספריית המדיה
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
התעריפים המוצגים מספקים אומדן לעלות לפני היצירה. החיוב הסופי מחושב לפי העלות שנרשמה עבור היצירה המקורית. משך הפלט שנמדד והכמויות החזויות אינם הכמות הסופית לחיוב.
מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה.
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | טבלת תעריפים | כמות חזויה | חיוב |
|---|---|---|---|
| תצורהתעריפי בסיס לטוקנים | טבלת תעריפיםתעריף בסיס | כמות חזויה— | חיוב קלט · טוקני קלט · אומדן להשוואה בלבד — / 1K טוקנים פלט · טוקני פלט · אומדן להשוואה בלבד — / 1K טוקנים קלט · קריאה מהמטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה · אומדן להשוואה בלבד — / 1K טוקנים |
| תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.24576 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'prompt': 'A cute baby sea otter', 'model': 'gpt-image-2.5-flare', 'size': '1024x1024', 'n': 1, 'background': 'auto', 'moderation': 'auto', 'output_format': 'png'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nהורידו כל תמונה שהוחזרה או שמרו את תוכן ה-Base64 שלה
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nשמרו כל תמונה שהושלמה; אחזרו אותה מכל URL שהוחזר או פענחו את תוכן ה-Base64 שלה.
שמרו את התשובה המלאה ואת הכותרות, כל פלט שהתקבל בפועל, את המזהים המקוריים שהוחזרו ואת כל שדות השימוש. שחזרו את הפעולה המקורית בלי לשלוח שוב בקשת יצירה.
שמרו את X-Client-Request-ID שהוחזר לצורך התאמת רישומים. קראו רק ערכי task_id/asset_id שהוחזרו בפועל או את ספריית המדיה שבבעלותכם; לעולם אל תבנו URL של משימה ממזהה הפעולה ואל תשלחו שוב בקשת יצירה.
| שדה | סוג |
|---|---|
שדהcreated | סוג |
שדהdata[].url | סוג |
שדהdata[].b64_json | סוג |
שדהusage | סוג |
Ailoot gpt-image-2.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare
/v1/images
openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare
openai/gpt-image-2.5-flareGPT Image 2.5 Flare יוצר ועורך תמונות מטקסט ומתמונות ייחוס, בדגש על יצירה חזותית יומיומית מהירה. הוא תומך בגדלים מותאמים, ברקעים שקופים, במסכות וברמות איכות עד max לטיוטות, לאיורים ולחומרי קמפיין.
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
GPT Image 2.5 Flare הוא מהדורת יצירת התמונות ועריכתן של OpenAI הממוצבת לעבודה יומיומית מהירה ואיכותית. הוא מקבל טקסט ותמונות ומחזיר תוצאות תמונה. השתמשו בו לטיוטות חזותיות, לאיורים, לרעיונות מוצר ולמשימות יצירתיות חוזרות שבהן תדריך צריך להפוך במהירות לתמונה שימושית. Flare נפרד מ־Sunburst, שמיצובו מדגיש דיוק בעריכה. בחרו Flare ליצירת תמונות שגרתית ו־Sunburst כשדיוק העריכה הוא העדיפות.
התחילו בנושא הראשי, בפעולה, בסביבה, בקומפוזיציה ובעיבוד החזותי. לאיור קמפיין, בקשו רוכב אופניים החוצה גשר קטן באור ערב חם, עם צללית בולטת ושמיים פתוחים לטקסט שיוסף בהמשך. תדריך בחינה תמציתי יכול להשאיר בחירות אסתטיות פתוחות; תדריך הפקה צריך לציין את הפרטים והמיקומים החשובים. תהליכי היצירה והעריכה הישירים מאפשרים הנחיות של עד 32,000 תווים ואחת עד עשר תוצאות, ולכן שימושי להשוות כמה גרסאות מול אותה מטרה.
בעריכה אפשר לספק עד שש־עשרה תמונות ייחוס. הקצו לכל ייחוס תפקיד ברור במקום לצפות שהמודל יחליט אם תמונה מייצגת זהות נושא, תפאורה או סגנון. מסכה יכולה להנחות שינוי באזור; עם כמה תמונות היא חלה על הראשונה. התמונה והמסכה זקוקות לפורמט ולמידות תואמים, והמסכה חייבת להכיל ערוץ אלפא. המדריך דורש שהמקור והמסכה יהיו קטנים מ־50 MB. מסכה היא הנחיה ולא הבטחה לשימור גבולות מדויק, לכן ציינו גם את השינוי הרצוי וגם מה צריך להישאר מזוהה.
Flare תומך באיכות low, medium, high, xhigh, max ואוטומטית, עם auto כברירת מחדל. איכות נמוכה יותר יכולה לשמש טיוטה חזותית מהירה; אפשר להשוות הגדרות גבוהות יותר לפרטי תוצר סופי. איכות אינה תלויה בגודל ובדחיסת הפלט. הגדלים הסטנדרטיים כוללים 1024 × 1024, 1536 × 1024 ו־1024 × 1536, ויש גם מידות אוטומטיות או מותאמות. בחרו את הכיוון בהתאם למיקום הסופי ולחלל השימושי בסצנה.
רוחב וגובה מותאמים חייבים להיות כפולות של שש־עשרה, כאשר אף צלע אינה עולה על 3840 פיקסלים. היחס המותר נע מ־1:3 עד 3:1, והשטח הכולל חייב להיות לפחות 655,360 ולכל היותר 8,294,400 פיקסלים. כל ארבעת התנאים חלים יחד. המדריך מזהה רזולוציות מעל 2560 × 1440 כניסיוניות. השתמשו במסגרת תקפה המתאימה לקומפוזיציה, וכללו בתדריך פרטים הרגישים לחיתוך במקום לראות ברזולוציה גדולה יותר שיפור פריסה אוטומטי.
פורמט התוצאה הוא PNG כברירת מחדל, עם חלופות JPEG ו־WebP. JPEG ו־WebP מאפשרים דחיסה מ־0 עד 100. לרקע שקוף, בחרו PNG או WebP; גם רקעים אטומים ואוטומטיים נתמכים. אפשר להציב נכס שקוף בפריסה מאוחרת, בעוד תמונה אטומה כוללת רקע משלה. בחרו פורמט, רקע ודחיסה לפי צורך המסירה בפועל, ושימרו את הקובץ שהושלם עם התדריך וההגדרות שנבחרו.
היצרן מתעד יצירת תמונות ועריכות ישירות, לצד כלי תמונות בשיחה היכול לשמר תוצאות נבחרות לשינויי המשך. בתהליך הזה הפעולה יכולה להיות אוטומטית, יצירה כפויה או עריכה כפויה כאשר תמונה נמצאת בהקשר. הזרמה יכולה להציג עד שלוש תמונות חלקיות לפני התוצאה הסופית. תצוגות אלה מראות התקדמות ואינן תוצרים מוגמרים נוספים. לעבודה איטרטיבית, המשיכו מהתמונה שנבחרה ותארו שינוי נראה, כגון הזזת עצם אחד או התאמת עיבוד הצבע. ממשק היצרן תומך גם בעיבוד באצווה.
בדקו בתמונה כיתוב, מיקום עצמים, פרטי נושא וקומפוזיציה בגודל המיועד. GPT Image עדיין עלול להתקשות במיקום טקסט מדויק, בפריסות מובנות ובזהות חזותית חוזרת בין יצירות. שימרו גרסה שאושרה כייחוס הבא וצמצמו את העריכה הבאה לבעיה החשובה. תפקיד היצירה היומיומית של Flare שימושי לרצף ברור של תדריך, חלופות חזותיות, בחירה וליטוש, כאשר התוצר הסופי נשפט לפי המטרה היצירתית בפועל.
POST /v1/images/generationstext, imageimage| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות openai/gpt-image-2.5-flare | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות אורך מזערי: 1 | ברירת מחדל— |
שדהaspect_ratio | סוגstring | דרישהרשות | ערכים ומגבלות 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, auto | ברירת מחדל— |
שדהquality | סוגstring | דרישהרשות | ערכים ומגבלות auto, low, medium, high, xhigh, max | ברירת מחדל— |
שדהbackground | סוגstring | דרישהרשות | ערכים ומגבלות auto, transparent, opaque | ברירת מחדל— |
שדהn | סוגinteger | דרישהרשות | ערכים ומגבלות מינימום: 1 מקסימום: 10 | ברירת מחדל— |
שדהinput_references | סוגarray | דרישהרשות | ערכים ומגבלות מספר פריטים מזערי: 0 מספר פריטים מרבי: 16 | ברירת מחדל— |
שדהoutput_compression | סוגinteger | דרישהרשות | ערכים ומגבלות מינימום: 0 מקסימום: 100 | ברירת מחדל— |
שדהprovider | סוגobject | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
| פרמטר | מפרט |
|---|---|
פרמטרcontent_type | מפרטapplication/json |
פרמטרrequired | מפרטmodel, prompt |
פרמטרmaterial_types | מפרטtext, image |
מחזור חיים: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · ערך task_id שהוחזר בפועל או רשומה בספריית המדיה
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
התעריפים המוצגים מספקים אומדן לעלות לפני היצירה. החיוב הסופי מחושב לפי העלות שנרשמה עבור היצירה המקורית. משך הפלט שנמדד והכמויות החזויות אינם הכמות הסופית לחיוב.
מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה.
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | טבלת תעריפים | כמות חזויה | חיוב |
|---|---|---|---|
| תצורהתעריפי בסיס לטוקנים | טבלת תעריפיםתעריף בסיס | כמות חזויה— | חיוב קלט · טוקני קלט · אומדן להשוואה בלבד — / 1K טוקנים פלט · טוקני פלט · אומדן להשוואה בלבד — / 1K טוקנים קלט · קריאה מהמטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה · אומדן להשוואה בלבד — / 1K טוקנים |
| תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.24576 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'openai/gpt-image-2.5-flare', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nהורידו כל תמונה שהוחזרה או שמרו את תוכן ה-Base64 שלה
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nשמרו כל תמונה שהושלמה; אחזרו אותה מכל URL שהוחזר או פענחו את תוכן ה-Base64 שלה.
שמרו את התשובה המלאה ואת הכותרות, כל פלט שהתקבל בפועל, את המזהים המקוריים שהוחזרו ואת כל שדות השימוש. שחזרו את הפעולה המקורית בלי לשלוח שוב בקשת יצירה.
שמרו את X-Client-Request-ID שהוחזר לצורך התאמת רישומים. קראו רק ערכי task_id/asset_id שהוחזרו בפועל או את ספריית המדיה שבבעלותכם; לעולם אל תבנו URL של משימה ממזהה הפעולה ואל תשלחו שוב בקשת יצירה.
| שדה | סוג |
|---|---|
שדהcreated | סוג |
שדהdata[].url | סוג |
שדהdata[].b64_json | סוג |
שדהusage | סוג |
Ailoot gpt-image-2.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare
/v1/images
openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare