API

Nano Banana Pro API

תמונה

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

הרשאות

Bearerstringheaderחובה

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

גוף

application/json

modelstringחובה

nano-banana-pro

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

POST /api/v1/create · HTTP 201

{
  "data": {
    "task_id": "task_example",
    "model": "nano-banana-pro",
    "status": "processing",
    "credits": 50
  }
}

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

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

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

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

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

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

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