מבוא ל-API התחלה מהירה Nano Banana Pro Nano Banana 2 Nano Banana 2 Lite

מתחילים

התחלה מהירה

התחילו להשתמש ב-Nano Banana API עם אסימון Bearer, גוף בקשת JSON ושתי נקודות הקצה לפרודקשן: create ו-check.

מה צריך

Aחשבון Nano Banana עם קרדיטים זמינים
מפתח API שנוצר מלוח מפתחות ה-API

קבלת מפתח ה-API שלכם

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

הגדרת כותרת בקשת HTTP

כתובת URL בסיסית

HTTPS

https://nanobanana.io

HTTP

Authorization: Bearer sk_live_your_api_key
Content-Type: application/json

התחלה מהירה

שלחו payload מסוג JSON כדי ליצור משימת יצירה אסינכרונית. שמרו את task_id שהוחזר והשתמשו בו כדי לבדוק את סטטוס המשימה.

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": "1k"
  }
}'

תגובה

{
  "data": {
    "task_id": "d0a8d9f2-5e01-4c5d-9f40-38d197a1c617",
    "model": "nano-banana-2",
    "status": "processing",
    "credits": 20
  }
}

יצירת משימה

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

POST/api/v1/create

הרשאות

שדה

סוג

חובה

תיאור ומגבלות

Authorizationstringחובה

מפתח API שמועבר כאסימון Bearer בכותרת הבקשה. דוגמה: Authorization: Bearer sk_live_your_api_key

גוף הבקשה

application/json

שדה

סוג

חובה

תיאור ומגבלות

modelstringחובה

מזהה מודל ציבורי. השתמשו במודל שמופיע באזור ה-API, לדוגמה nano-banana-2.

inputobjectחובה

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

JSON

{
  "model": "nano-banana-2",
  "input": {
    "prompt": "צילום מוצר קולנועי של מצלמה עתידנית בצורת בננה",
    "aspect_ratio": "1:1",
    "resolution": "1k"
  }
}

תגובת יצירה

application/json

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

HTTP 201

{
  "data": {
    "task_id": "d0a8d9f2-5e01-4c5d-9f40-38d197a1c617",
    "model": "nano-banana-2",
    "status": "processing",
    "credits": 20
  }
}

קבלת סטטוס משימה

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

POST/api/v1/check

גוף הבקשה

application/json

שדה

סוג

חובה

תיאור ומגבלות

task_idstringחובה

מזהה המשימה שמוחזר על ידי POST /api/v1/create. השתמשו במזהה זה כדי לקבל את סטטוס המשימה ואת כתובות ה-URL של התוצאות הסופיות.

JSON

{
  "task_id": "d0a8d9f2-5e01-4c5d-9f40-38d197a1c617"
}

תגובת סטטוס

application/json

לאחר השלמת העיבוד, התגובה כוללת כתובות URL לתוצאות הסופיות ומטא-נתוני תזמון. כל עוד המשימה עדיין פועלת, data מוחזר כ-null.

HTTP 200

{
  "id": "adc0e6ec-9c12-44fc-b45f-112187766c3",
  "created_at": 1788652800,
  "model": "nano-banana-2",
  "status": "completed",
  "data": {
    "results": [
      "https://cdn.nanobanana.io/api/predictions/example.mp4"
    ],
    "processing_time": 48
  }
}