דילוג לתוכן
מגרש משחקים API

מגרש משחקים API

אינטראקטיבי

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

הפעלת Playground

ה-playground הוא קונסולת צ'אט ל-API בכתובת /docs/playground. אתם משוחחים עם מודל, וה-playground שולח את אותן בקשות שהקוד שלכם היה שולח: לאחד משלושה endpoints, עם המודל, ה-system prompt, הפרמטרים והכלים שקבעתם. כל בקשה אפשר לקרוא בחזרה כקוד וכאירועי stream גולמיים.

התחלה

  • תנו לו מפתח — כשאתם מחוברים, ה-playground משתמש במפתח ה-API של החשבון שלכם ומראה את היתרה. כשאתם לא מחוברים, בחרו הוספת מפתח והדביקו מפתח: הוא נשמר בלשונית הזו בלבד ואינו נשמר לעולם.
  • בחרו endpoint ומודל — הסרגל העליון מכיל את מתג ה-endpoint ואת בורר המודלים. שיחה חדשה מתחילה ב-Chat Completions עם shannon-3.
  • שלחו הודעה — הקלידו למטה ולחצו Enter. כל תשובה מצטרפת לשיחה, ולכן ההודעה הבאה ממשיכה אותה. המסך הריק מציע שלושה פרומפטים להתחלה ודוגמה מוכנה של קריאה לכלי.

את המפתח שלכם מוצאים ומחליפים בדף מפתחות ושימוש. מפתחות ושימוש

Endpoints ומודלים

מתג ה-endpoint קובע באיזה פורמט בקשה ה-playground בונה. אפשר לשנות אותו באמצע שיחה; ההודעות נשארות.

Endpoint הבקשה שהוא שולח הפניה
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages פורמט Anthropic

בורר המודלים מפרט את מה ש-GET /v1/models מחזיר. אפשר לחפש בו, הוא שומר את המודלים האחרונים שלכם למעלה, ומראה לכל מודל את המחיר לכל 1M טוקנים, את חלון ההקשר וסימונים לכלים, קלט תמונה, reasoning ופלט מובנה.

השיחה

  • תשובות זורמות לשיחה תוך כדי כתיבה. ה-reasoning של המודל מוצג בבלוק משלו שאפשר לקפל.
  • מתחת לכל תשובה: הזמן עד הטוקן הראשון, טוקנים לשנייה, הזמן שחלף, טוקני קלט ופלט עם החלקים במטמון וב-reasoning, הערכת העלות של התור, סיבת הסיום ומזהה התשובה.
  • הודעה שלכם אפשר לערוך ולשלוח שוב מאותה נקודה. תשובה אפשר ליצור מחדש. הודעה אפשר למחוק, ואת המחיקה אפשר לבטל במשך כמה שניות.
  • עצירה או מקש Esc מסיימים תשובה שנכתבת.
  • תמונות מצורפות עם כפתור התמונה, בהדבקה או בגרירת קובץ, במודלים שמקבלים תמונות. תמונה מוקטנת ל-1,568 פיקסלים בצלע הארוכה שלה לפני שליחה. קובץ מעל 30 MB מדולג.
  • שדה ההקלדה וה-system prompt מראים ספירת טוקנים. במודלי ה-open-weight המתארחים זו הספירה המדויקת מ-POST /v1/tokenize. בשאר המודלים זו הערכה, המסומנת ב-≈.
  • בקשה שנכשלה מראה מה לעשות הלאה: לקבוע מפתח כשהמפתח נדחה, לטעון קרדיט כשהיתרה נוצלה, כמה שניות להמתין אחרי יותר מדי בקשות, או לנסות שוב אחרי שגיאת שרת.

הגדרות בקשה

הכפתור הגדרות פותח לוח עם שש לשוניות. ההגדרות שייכות לשיחה: לכל שיחה יש הגדרות משלה.

לשונית מה זה מכיל
System ה-system prompt של השיחה, שנשלח בכל בקשה. חמש תבניות ממלאות אותו, ומספר הטוקנים שלו מוצג.
פרמטרים מקסימום טוקני פלט, טמפרטורה, top_p, reasoning effort, רצפי עצירה, seed, והמתגים של streaming וחיפוש ברשת. פקד שאין לו שדה ב-endpoint שנבחר כבוי ומסומן.
כלים הגדרות כלים שנשלחות עם הבקשה: ארבע הגדרות מוכנות (get_weather, read_file, run_shell, web_search) או הגדרה משלכם כ-JSON, ו-tool_choice (auto, none, required או כלי אחד בשם). כשהמודל קורא לכלי, השיחה מראה את הקריאה עם תיבה לתוצאה. כש-הצעת תוצאות לדוגמה מופעלת, לחיצה אחת ממלאת תוצאה לדוגמה. אפשר גם להקליד תוצאה משלכם ואז לשלוח אותה כדי להמשיך את התור.
מובנה response_format: text, json_object או json_schema עם שם סכמה וסכמת JSON. כשנקבעה סכמה, התשובה האחרונה נבדקת מולה ומסומנת בשיחה כמתאימה או לא. הלשונית כבויה ב-endpoint של Messages, ואפשרות שהמודל שנבחר אינו מקבל אינה מוצעת.
קוד הבקשה של השיחה הנוכחית כקוד cURL, Python, Node או Go, שנבנה מהשיחה וההגדרות שלה. המפתח מודפס כ-YOUR_API_KEY. אפשר להעתיק את הקוד או לפתוח אותו בתצוגה גדולה.
אירועים התור האחרון כפי שעבר בחוט: כל אירוע stream עם היסט הזמן שלו ומסנן, התשובה המורכבת, כותרות התשובה (x-request-id, content-type, retry-after, date) וגוף הבקשה. אלה נשמרים עד לטעינה מחדש של הדף.

בדיקות קלט

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

הגדרה בדיקה
מקסימום טוקני פלט מספר שלם מ-1 עד max_output_tokens של המודל.
טמפרטורה מספר מ-0 עד 2. ריק משאיר את השדה מחוץ לבקשה.
top_p מספר מ-0 עד 1. ריק משאיר את השדה מחוץ לבקשה.
seed מספר שלם.
רצפי עצירה לכל היותר 4, מופרדים בפסיקים.
response_format חייב להיות אחד שהמודל שנבחר מקבל. שיחה שהועברה למודל בלי json_schema או בלי response_format נעצרת עם הסיבה.
תמונות מוסרות מההודעה כשעוברים למודל שמקבל טקסט בלבד, עם הערה.

השוואת שני מודלים

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

שיתוף, ייצוא וייבוא

  • העתקת קישור לשיתוף אורזת את השיחה בתוך הקישור עצמו, בחלק שאחרי #. דבר אינו מועלה. תמונות, המפתח שלכם ופרטי ההרצה האחרונה מושמטים. מי שפותח את הקישור מקבל את השיחה כשיחה חדשה ב-playground שלו.
  • שיחה ארוכה מדי לקישור נדחית עם הערה. הורידו אותה במקום זאת כ-JSON.
  • הורדת JSON של השיחה שומרת את השיחה עם ההגדרות שלה כקובץ. ייבוא JSON בלוח השיחות פותח קובץ כזה.
  • העתקה כ-cURL מעתיקה את הבקשה הנוכחית כפקודת cURL אחת.

מה נשמר ואיפה

מה איפה זה נשמר
שיחות, כלים שמורים, מודלים אחרונים, פריסת הלוחות בדפדפן הזה. הם אינם נשלחים ל-Shannon ואינם עוברים איתכם למכשיר אחר.
מפתח API בזיכרון של הלשונית הפתוחה. מפתח שהודבק נעלם כשהדף נטען מחדש או כשהלשונית נסגרת. כשאתם מחוברים, המפתח נקרא מהחשבון שלכם בכל פעם.
אירועי stream, כותרות ובקשה של התור האחרון בדף הפתוח, עד לטעינה מחדש שלו.
בקשות נשלחות מהדפדפן שלכם ל-API עם המפתח שלכם. הן נספרות מול היתרה שלכם כמו כל בקשת API אחרת.

מקלדת

מקשים מה זה עושה
Enter שליחת ההודעה.
Shift + Enter התחלת שורה חדשה.
Ctrl + K פתיחת לוח הפקודות: החלפת endpoint או מודל, קביעת תבנית system, התחלת שיחה חדשה, הפעלה או כיבוי של streaming, כלים או השוואה. ב-Mac: ⌘ K.
Esc עצירת התשובה שנכתבת, או סגירת לוח פתוח במסך צר.

הפעלת Playground