API

Seedream 5.0 Pro API

תמונה

ה-API של Seedream 5.0 Pro תומך ביצירת תמונות מטקסט ובעריכת תמונות עזר, עם יחסי רוחב-גובה גמישים ופלט ב-1K או 2K.

הרשאות

Bearerstringheaderחובה

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

גוף

application/json

modelstringחובה

seedream-5-0-pro

input.promptstringחובה

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

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

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

עד 16 פריטים.

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

יחס הרוחב לגובה של תמונת הפלט. ברירת מחדל: 1:1.

ברירת מחדל: 1:1

1:116:99:163:22:33:44:321:9

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

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

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

1k2k

דוגמאות בקשה

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

POST /api/v1/create · HTTP 201

{
  "data": {
    "task_id": "task_example",
    "model": "seedream-5-0-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": "seedream-5-0-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": "seedream-5-0-pro",
    "status": "failed",
    "data": null,
    "failed_reason": "Generation failed."
  }
}

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

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

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

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

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

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