API Reference
רמות המודל
הקראת רמת מחיר אחרת של אותו מודל באמצעות מפתח API יחיד.
חלק מהמודלים מוצעים ביותר מרמה אחת. רמה היא אותו מודל שנמכר במחיר שונה, למשל רמה בעלות נמוכה יותר לצד ברירת המחדל. מפתח API אחד מגיע לכל רמה; בחר רמה לפי שם המודל, לא לפי מפתח או הגדרה נפרדת.
רמת ברירת המחדל
שם המודל הפשוט תמיד משתמש ברמת ברירת המחדל. בקשות קיימות ממשיכות לעבוד כפי שהן כאשר מודל מקבל רמה נוספת.
{ "model": "gpt-image-2" }בחר רמה
הוסף קולון ומזהה הרמה לשם המודל:
{ "model": "gpt-image-2:<tier>" }זה עובד עבור מודלים טקסט, תמונה, וידאו ואודיו, בכל מקום שבו הבקשה מציינת מודל: השדה model של גוף JSON, שדה הטופס model של העלאת אודיו, וקטע המודל של נתיב Gemini מקורי. בנתיב Gemini הפעולה נשארת אחרונה:
POST /v1beta/models/<model>:<tier>:generateContentמצא את הרמות של מודל
- בכל עמוד מודל, כפתור בחירת הרמה מופיע מעל טבלת המחירים ומציג את המחירים של כל רמה ואת מזהה המודל להקריאה. בעמודים עם מחיר יחיד, הרמות מוצגות בטבלה רמות המחיר במקום זאת. שתיהן מופיעות רק כאשר למודל יש יותר מרמה אחת.
- המדריך Markdown
/models/<page>/llms.txtשל כל מודל מפרט את המחירים המלאים של כל הרמות. GET /v1/modelsמציינת<model>:<tier>לצד<model>לכל מודל שהמפתח שלך יכול להקריא ביותר מרמה אחת.
ב-Playground של מודלי טקסט, בחירת הרמה משנה בין אותן הרמות. ה-Playground של מודלי תמונה, וידאו ואודיו משתמש ברמת ברירת המחדל; לרמות אחרות פנו דרך ה-API.
חיוב והתנהגות
- בקשת רמה פועלת רק בתוך רמה זו וחויבת במחיר של רמה זו.
- אם הרמה לא יכולה לשרת את הבקשה, הבקשה נכשלת. היא לעולם לא משנה לרמה אחרת, ולכן לעולם לא תחויב במחיר שונה.
- תגובות ותוצאות משימות מדווחות את שם המודל הפשוט.
- מפתח שנוצר לרמה אחת בלבד יכול להקריא רמה זו ולא אחרת.
שגיאות
| קוד | סיבה |
|---|---|
20002 | הרמה אינה קיימת, אינה מציעה מודל זה, או שנקודת הקצה אינה מקבלת רמות. |
10002 | המפתח אינו רשאי להשתמש ברמה המבוקשת. |
ראה שגיאות למבנה התשובה.
