API

Nano Banana 2.1 API

תמונה

ה־API של Nano Banana 2.1 מספק תמונות חדות יותר ועריכה מדויקת יותר. צרו תמונות מהנחיות טקסט או ערכו תמונות ייחוס, עם יחסי רוחב־גובה גמישים ופלט ברזולוציה של עד 4K. שלבו את ה־API כדי להוסיף לאפליקציה שלכם יצירה ועריכה של תמונות באיכות גבוהה.

הרשאות

Bearerstringheaderחובה

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

גוף

application/json

modelstringחובה

nano-banana-2-1

input.promptstringחובה

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

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

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

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

יחס הרוחב לגובה של הפלט. Auto מאפשר למודל לבחור.

ברירת מחדל: auto

auto1:12:33:23:44:34:55:49:1616:921:91:44:11:88:1

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

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

ברירת מחדל: 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": "nano-banana-2-1",
  "input": {
    "prompt": "צילום מוצר קולנועי של מצלמה עתידנית בצורת בננה",
    "aspect_ratio": "1:1",
    "resolution": "2k"
  }
}'

POST /api/v1/create · HTTP 201

{
  "data": {
    "task_id": "task_example",
    "model": "nano-banana-2-1",
    "status": "processing",
    "credits": 20
  }
}

בצעו 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": "nano-banana-2-1",
    "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": "nano-banana-2-1",
    "status": "failed",
    "data": null,
    "failed_reason": "Generation failed."
  }
}

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

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

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

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

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

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