API

GPT Image 2.5 API

תמונה

ממשק GPT Image 2.5 API מביא ליישום שלכם את המודלים המתקדמים ביותר של OpenAI ליצירה ולעריכה של תמונות. צרו תמונות מטקסט או ערכו תמונות ייחוס, עם יחסי רוחב־גובה גמישים ופלט ב־1K, ב־2K או ב־4K. בחרו flare ליצירה יומיומית מהירה ואיכותית, או sunburst לעבודה יצירתית תובענית ולעריכת תמונות מדויקת.

הרשאות

Bearerstringheaderחובה

מפתח API לאישור בקשות

גוף

application/json

modelstringחובה

gpt-image-2-5

input.promptstringחובה

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

input.modestringאופציונלי

בחרו את גרסת GPT Image 2.5. flare היא ברירת המחדל ומעדיפה מהירות ליצירה יומיומית איכותית ולשינויים מהירים. sunburst מעדיפה דרישות איכות גבוהות ודיוק בעריכה, ומתאימה במיוחד כשחשוב לבצע שינויים מדויקים בתמונות הייחוס.

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

ברירת מחדל: flare

flaresunburst

input.imagesstring[]אופציונלי

כתובות URL אופציונליות לתמונות ייחוס. השתמשו רק בכתובות HTTPS נגישות לציבור. השמיטו את השדה ליצירת תמונות מטקסט.

input.aspect_ratiostringאופציונלי

יחס הרוחב לגובה של תמונת הפלט. auto מאפשר למודל לבחור קומפוזיציה מתאימה. בחרו יחס מהרשימה לקביעת הפורמט, למשל 1:1 לתמונות מרובעות, 9:16 לתמונות אנכיות או 16:9 לתמונות אופקיות.

ברירת מחדל: auto

auto1:12:33:23:44:39:1616:921:9

input.resolutionstringאופציונלי

רמת רזולוציית הפלט. השתמשו בערכים 1k,‏ 2k או 4k באותיות קטנות לבחירת הרמה המתאימה. הגדירו שדה זה במפורש כאשר נדרשת רזולוציה מסוימת.

ברירת מחדל: 2k

1k2k4k

דוגמאות בקשה

POST /api/v1/create

curl -X POST https://nanobanana.io/api/v1/create \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2-5",
  "input": {
    "prompt": "צילום מוצר קולנועי של מצלמה עתידנית בצורת בננה"
  }
}'

POST /api/v1/create · HTTP 201

{
  "data": {
    "task_id": "task_example",
    "model": "gpt-image-2-5",
    "status": "processing",
    "credits": 5
  }
}

בצעו polling לנקודת הקצה באמצעות מזהה המשימה שהוחזר עד שהמשימה תושלם או תיכשל. אנו ממליצים לבצע polling כל 5 שניות כדי לבדוק את הסטטוס העדכני.

POST /api/v1/check

{
  "task_id": "task_example"
}

תגובה

מצב המשימה שמוחזר מ־POST /api/v1/check. המזהים, כתובות ה־URL וחותמות הזמן להלן הם דוגמאות.

idstringחובה

מזהה המשימה בשדה data.id זהה ל־task_id שנשלח בבקשת הבדיקה.

statusstringחובה

completed מציין שהיצירה הצליחה ו־data.data מכיל את התוצאות. במצבים אחרים data.data הוא null.

failed_reasonstringאופציונלי

מוחזר רק כאשר status הוא failed ומסביר את סיבת הכישלון. שדה זה אינו מופיע ב־completed או ב־processing.

הושלמה · completed

כתובות ההורדה נמצאות ב־data.data.results.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "gpt-image-2-5",
    "status": "completed",
    "data": {
      "results": [
        "https://example.com/generated.png"
      ],
      "processing_time": 18
    }
  }
}

מצבים אחרים

ב־processing או ב־failed השדה data.data הוא null. הדוגמה מציגה failed: רק failed כולל failed_reason. המשיכו לבדוק ב־processing והפסיקו ב־failed.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "gpt-image-2-5",
    "status": "failed",
    "data": null,
    "failed_reason": "Generation failed."
  }
}

צריכת קרדיטים

הקרדיטים הנצרכים בבקשה שמייצרת תמונה אחת.

הקרדיטים הנצרכים בבקשה שמייצרת תמונה אחת.
רזולוציה	1K	2K	4K
תמונה אחת	12	36	50

ללא פרמטרים אופציונליים: 5 קרדיטים

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

השדה credits בתשובה של POST /api/v1/create מציג את הקרדיטים שחויבו עבור המשימה.