מפתח API ל-GPT Image 2: איך מקבלים גישה ושולחים בקשה ראשונה

כן, ל-GPT Image 2 יש API, וב-SeedRouter מפתח API אחד נותן לך גישה אליו. התחבר, צור מפתח בעמוד מפתחות API, הוסף קרדיטים בעמוד החיוב, ושלח את המפתח בכותרת Authorization: Bearer אל https://api.seedrouter.ai/v1/images/generations. המפתח מוצג במלואו פעם אחת בלבד, ברגע שאתה יוצר אותו, ולכן העתק אותו מיד למשתני הסביבה של השרת שלך.

השלבים הבאים לוקחים אותך מאפס חשבון ועד תמונה מוכנה, ומכסים את ארבע השגיאות שעוצרות את רוב הבקשות הראשונות.

איך משיגים מפתח API ל-GPT Image 2?

1. התחבר ל-SeedRouter עם חשבון Google שלך.
2. פתח את מפתחות API וצור מפתח. תן לו שם שמציין איפה הוא ירוץ, למשל production-server.
3. העתק את המפתח מיד. אחרי המסך הזה תראה רק גרסה מוסתרת, ומפתח שאבד אי אפשר לשחזר. במקום זאת, בטל אותו וצור מפתח חדש.
4. הוסף קרדיטים בעמוד החיוב. מפתח עובד מהרגע שהוא נוצר, אבל בקשה צריכה קרדיטים כדי לרוץ.

מפתח אחד מגיע לכל המודלים ב-SeedRouter, כך שאין צורך במפתח נפרד ל-GPT Image 2 ול-GPT Image 2.5. במקום זאת, צור מפתח נפרד לכל סביבה. כך ביטול המפתח של סביבת ה-staging לא יכול לשבור את סביבת הייצור.

איפה צריך לשמור את מפתח ה-API?

בשרת שלך, במשתנה סביבה, ובשום מקום אחר:

export SEEDROUTER_API_KEY="your-key"

לעולם אל תכניס את המפתח ל-JavaScript שרץ בדפדפן, לחבילה של אפליקציית מובייל או למאגר קוד ציבורי. כל מי שקורא אותו יכול להוציא את הקרדיטים שלך. אם למוצר שלך יש צד לקוח, תן לו לקרוא לצד השרת שלך, ותן לצד השרת לקרוא ל-API עם המפתח.

אם מפתח בכל זאת דלף, בטל אותו מיד בעמוד מפתחות API. מפתח שבוטל מפסיק לעבוד, ובקשות שמשתמשות בו נדחות.

איך שולחים בקשה ראשונה עם המפתח?

שלח את המפתח כ-bearer token. התגובה היא הפניה למשימה, לא התמונה:

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "An amber glass bottle on a cream background, studio lighting",
    "size": "1024x1024",
    "quality": "low"
  }'

שמור את ה-id מהתגובה ותשאל את GET https://api.seedrouter.ai/v1/tasks/{id} עם אותה כותרת עד ש-status יהיה completed. המשימה שהושלמה מפרטת את כתובות התמונות. ללולאה מלאה בקוד, ראה את GPT Image 2 API ב-Python.

שני מזהי מודל מגישים את GPT Image 2 עם אותם שדות: gpt-image-2 מחייב מחיר קבוע אחד לכל תמונה שנמסרה, ו-gpt-image-2-official מחייב לפי הטוקנים שכל רינדור מדווח. המפתח עובד עם שניהם. המחירים הנוכחיים מופיעים בעמוד המודל.

באילו שגיאות נתקל בדרך כלל מפתח API חדש?

שתי טעויות גורמות לרוב הכישלונות בבקשה הראשונה. האחת היא מפתח שהודבק עם תו חסר או רווח מיותר, שמחזיר 10001. השנייה היא העתקת שם המודל מכותרת, כמו gpt-image-2.0 או GPT Image 2, במקום מזהה המודל, שמחזירה 20002. שתיהן נדחות לפני שעבודה כלשהי מתחילה, ולכן שום דבר לא מחויב.

האם יש מפתח API חינמי ל-GPT Image 2?

לא. יצירת מפתח היא בחינם, אבל הבקשות משולמות מקרדיטים ששולמו מראש. מה שאתה לא משלם עליו הוא כישלון: משימה שמסתיימת ב-failed, או שלא מחזירה תמונה, לא עולה כלום. הקרדיטים נקנים בטעינות חד-פעמיות, לא פגים לעולם ואינם כרוכים במנוי, כך שטעינה ראשונה קטנה מספיקה כדי לבדוק אינטגרציה כמו שצריך.

אפשר להשתמש במפתח אחד מ-Python ומ-JavaScript?

כן. המפתח הוא מחרוזת בכותרת HTTP, כך שכל שפה שיכולה לשלוח בקשת HTTP יכולה להשתמש בו. קרא אותו ממשתני הסביבה בכל סביבת ריצה: os.environ["SEEDROUTER_API_KEY"] ב-Python ו-process.env.SEEDROUTER_API_KEY ב-Node.js. השאר את ה-JavaScript בצד השרת; אותו מפתח בקוד דפדפן חשוף לכל מבקר.

שאלות נפוצות

האם צריך מפתח API של OpenAI כדי להשתמש כאן ב-GPT Image 2?

לא. מפתח ה-SeedRouter שלך הוא פרט ההזדהות היחיד שאתה שולח. אינך יוצר או מנהל חשבון נפרד במקום אחר כדי לקרוא ל-GPT Image 2 דרך ה-API הזה.

כמה מפתחות API אפשר ליצור?

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

איפה רואים כמה מפתח הוציא?

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

השאר את המפתח בשרת והתחל לעבוד

צור מפתח לכל סביבה, שמור אותו במשתנה סביבה, ושלח אותו כ-bearer token מצד השרת שלך בלבד. כשהבקשה הראשונה מחזירה id של משימה, חלק הגישה הושלם; כל מה שבא אחר כך נמצא בתיעוד ה-API של GPT Image 2.