API

Nano Banana 2 API

תמונה

Nano Banana 2 API משלב ידע עולמי בזמן אמת עם reasoning מתקדם כדי לספק הבנה טובה יותר של prompts ותוצאות חזותיות מדויקות יותר. צרו תמונות עקביות עם מספר נושאים ב-4K מקורי, תמיכה ביחסי ממדים גמישים וטיפוגרפיה גלובלית איכותית גם בקומפוזיציות מורכבות. שלבו Nano Banana 2 API כדי לבנות תהליכי תמונה חכמים, איכותיים וניתנים להרחבה.

הרשאות

Bearerstringheaderחובה

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

גוף

application/json

modelstringחובה

nano-banana-2

input.promptstringחובה

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

אורך מרבי: 5,000 תווים

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

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

מספר פריטים מרבי: 14

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

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

ברירת מחדל: auto

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

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

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

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

POST /api/v1/create · HTTP 201

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

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

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

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

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

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

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

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