יומן שינויים

בקשה עם web_search: true נותנת שם למקורותיה: sources ב-/v1/chat/completions וב-/v1/messages מפרט את התוצאות שהמודל קיבל, וב-/v1/chat/completions השדה annotations מסמן היכן התשובה מצטטת כל אחת מהן. חיפוש ווב מובנה

web_search: true ב-/v1/chat/completions וב-/v1/messages מריץ חיפוש ברשת לפני שהמודל עונה ונותן לו את התוצאות כמקורות ממוספרים. בקשה שמצאה תוצאות משתמשת בחיפוש אחד מהמכסה היומית שלכם. כשלא נשאר, הבקשה נענית בלי חיפוש. חיפוש ווב מובנה

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

shannon-coder-1 עונה ב-/v1/responses כמו בשני ה-endpoints האחרים. כלי קידוד ב-CLI

מפתח API שהוחלף מפסיק לעבוד מיד.

POST /v1/tokenize ו-POST /v1/messages/count_tokens: ספירות טוקנים חינמיות עבור מודלי open-weight מתארחים. ספירת טוקנים

מטמון פרומפטים במודלי open-weight מתארחים. קלט במטמון מחויב ב-25% ממחיר הקלט ומדווח ב-usage בכל שלושת ה-endpoints: prompt_tokens_details.cached_tokens, input_tokens_details.cached_tokens ו-cache_read_input_tokens. GET /v1/models מדווח pricing.cached_input_per_million_usd ו-capabilities.prompt_caching עבור המודלים האלה. מטמון פרומפטים (Prompt caching)

מודלי open-weight מתארחים: tool_choice כפוי (required או פונקציה בשם) מניב קריאה לכלי. קריאת פונקציות

מודלי open-weight מתארחים מקבלים הודעת system שאינה ההודעה הראשונה בשיחה.

ה-API זמין כשירות onion ב-Tor ובכתובת I2P. תשובות של api.shannon-ai.com נושאות את שתי הכתובות בכותרות Onion-Location ו-X-I2P-Location. Endpoints מוצפנים, Tor ו-I2P

מודלים חדשים shannon-3.1 ו-shannon-3.1-pro, שמופיעים ב-GET /v1/models. מודלים ותמחור

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

בקשות ל-/v1/responses מופיעות ביומן השימוש.

מודלי open-weight מתארחים מיישמים את שדות הדגימה: temperature, top_p, seed, stop ו-max_tokens ב-/v1/chat/completions; temperature, top_p ו-stop_sequences ב-/v1/messages; temperature, top_p ו-max_output_tokens ב-/v1/responses. Chat Completions

יומן השימוש מציג עלות ב-USD לכל קריאה וכסכום כולל.

ערך model שאינו מזהה שפורסם נענה ב-400, בסוג invalid_request_error ובהודעה unknown model: <id> בכל שלושת ה-endpoints. קודם לכן בקשה כזו נענתה על ידי shannon-1.6-lite. מודלים ותמחור

/v1 מקבל מפתח API בלבד. עוגיית התחברות של האתר אינה נקראת שם. אימות

הגנת הצפה: 120 בקשות בדקה לחשבון בשלושת ה-endpoints של היצירה. מגבלות ויתרה

כשהמודל אינו יכול לענות, השגיאה נושאת את ההודעה הקבועה The model backend failed to answer. Please retry. בדיקת יתרה שאי אפשר לבצע נענית ב-503 ובסוג api_error. טיפול בשגיאות

בקשה שאינה ב-streaming ונכשלת מחזירה את ההפרשה שלה ליתרה שלכם.

GET /v1/models מדווח capabilities.reasoning_effort לכל מודל. רמת מאמץ ה-reasoning

מודלי open-weight מתארחים: בקשה שאינה ב-streaming ולא מקבלת תשובה מסתיימת ב-504 ובסוג api_error. תוצאה ריקה היא 502. טיפול בשגיאות

מודלי open-weight מתארחים מקבלים את הקלט שהמודל הנקוב מקבל. תמונה שנשלחה למזהה של טקסט בלבד נענית ב-400 וב-<id> does not accept image input. response_format על מזהה בלי פלט מובנה נענה ב-400. GET /v1/models מדווח capabilities.vision, response_format ו-json_schema לכל מזהה. תמונות וקבצים

תשובות שאינן ב-streaming נושאות את טקסט ה-reasoning: reasoning_content בהודעה של /v1/chat/completions, ובלוק thinking לפני הטקסט ב-/v1/messages. רמת מאמץ ה-reasoning

למודלי open-weight מתארחים יש מחירים חדשים, החל מ-$0.50 ל-1M טוקני קלט ו-$2.00 ל-1M טוקני פלט. מודלים ותמחור

למודלי open-weight מתארחים יש מזהה אחד לכל מודל, שנים-עשר מזהים בסך הכול. מודלים ותמחור

פלט מובנה ב-shannon-3, shannon-3-pro, shannon-3.1 ו-shannon-3.1-pro. GET /v1/models מדווח עבורם capabilities.json_schema: true. פלט מובנה

/v1/responses קורא את text.format (json_object או json_schema) לפלט מובנה. Responses API

/v1/responses מחזיר את ה-reasoning של מודלי Shannon: פריט פלט reasoning לפני פריט ה-message, ואירועי ה-stream‏ response.reasoning_summary_text.delta ו-response.reasoning_summary_text.done. Responses API

שדה ה-model של תשובה הוא המזהה שפורסם בכל endpoint. אובייקט Responses נושא model ו-created_at.

GET /v1/models מדווח על חלון ההקשר של כל מודל. מודלים ותמחור

מודלי open-weight מתארחים עונים גם ב-/v1/messages וב-/v1/responses, ולא רק ב-/v1/chat/completions, עם ה-system prompt וקריאות הכלים שלכם. /v1/messages מקבל thinking, ו-reasoning_effort הוא שדה בבקשה. מודלים ותמחור

גופי שגיאה ב-/v1 עוקבים אחרי הצורות של ה-SDK: אובייקט error עם type ו-message ב-endpoints בפורמט OpenAI, ואותו אובייקט בתוך {"type": "error"} ב-/v1/messages. טיפול בשגיאות

Keep-alive ב-streams פתוחים כל 15 שניות: שורת הערה : ping ב-/v1/chat/completions, ו-event: ping ב-/v1/messages. הזרמה

מזהי קריאות לכלים מתחילים ב-call_ ב-/v1/chat/completions וב-/v1/responses, וב-toolu_ ב-/v1/messages. קריאת פונקציות

/v1/responses: ברירת המחדל של stream היא false. Responses API

max_completion_tokens מתקבל כשם חלופי ל-max_tokens ב-/v1/chat/completions. Chat Completions

אירוע response.completed של stream ב-Responses נושא את מערך ה-output. Responses API

פריטי GET /v1/models נושאים display_name, context_window, max_output_tokens, pricing, capabilities ו-endpoints. מודלים ותמחור

כל תשובה נושאת x-request-id, וערך שאתם שולחים מוחזר. גופי בקשות יכולים להגיע עד 32 MiB.

אפשר לבטל מפתח בלי שיונפק חדש. יומן השימוש מחולק לעמודים.

תמונות ומסמכים בבקשות: חלקי image_url ב-/v1/chat/completions, בלוקי image, document ו-file ב-/v1/messages, חלקי input_image ב-/v1/responses. תמונות וקבצים

מודל חדש shannon-3-pro. מודלים ותמחור

מודל חדש shannon-3. מודלים ותמחור

Streams ב-/v1/chat/completions נושאים את ה-reasoning כ-delta.reasoning_content. רמת מאמץ ה-reasoning

max_tokens נשמר בין 1 ל-65,536. ערך מחוץ לטווח הזה מועבר לקצה הקרוב ביותר ואינו נדחה. Chat Completions

shannon-coder-1 נספר בקריאות לתוכנית ב-/v1/chat/completions וב-/v1/messages. כשקריאות החלון נוצלו, התשובה היא 429 עם ההודעה Shannon Coder call quota reached. כלי קידוד ב-CLI

שיחה גדולה מחלון ההקשר נענית ב-400, בסוג invalid_request_error ובקוד context_length_exceeded. שגיאה בתוך stream מגיעה כאירוע שגיאה, לא כטקסט בתשובה. כלי קידוד ב-CLI

ה-endpoints של /v1: POST /v1/chat/completions, POST /v1/messages, POST /v1/responses ו-GET /v1/models. אלה ה-endpoints שה-SDK של OpenAI ושל Anthropic, Claude Code ו-Codex CLI קוראים להם. סקירה

קריאות לכלים עם tools ב-/v1/chat/completions וב-/v1/messages, פלט מובנה עם response_format, ו-system כמחרוזת או כבלוקי טקסט ב-/v1/messages. קריאת פונקציות

מזהי המודלים shannon-1.6-pro, shannon-2-lite, shannon-2-pro ו-shannon-coder-1, לצד shannon-1.6-lite. מודלים ותמחור

הגרסה הראשונה של ה-API: צ'אט בפורמט OpenAI ובפורמט Anthropic, ו-endpoint של Responses, שכל אחד נקרא עם מפתח API שמתחיל ב-sk-. אימות