הגדרת API ל-SillyTavern: כתובת בסיס, מפתח API ורשימת מודלים
Updated 2026-07-15
ב-SillyTavern, בחרו Chat Completion, הגדירו את המקור ל-Custom (OpenAI-compatible), הדביקו כתובת בסיס שמסתיימת ב-/v1, והוסיפו את מפתח ה-API שלכם. רשימת המודלים הנפתחת תתמלא אז לבד מה-endpoint של /v1/models אצל הספק.
תשובה מהירה: חמש ההגדרות שחשובות
פתחו את פאנל ה-API Connections (סמל התקע) והגדירו בדיוק כך: API = Chat Completion. Chat Completion Source = Custom (OpenAI-compatible). Custom Endpoint (Base URL) = https://api.apisrouter.com/v1. Custom API Key = מפתח ה-sk-... שלכם. לחצו Connect, המתינו לנורה הירוקה, ובחרו מודל מהרשימה הנפתחת, לדוגמה deepseek-v4-flash. הכשל הנפוץ ביותר הוא הדבקת הנתיב המלא. SillyTavern מוסיף /chat/completions לכל מה שתזינו, כך שהכתובת חייבת להיעצר ב-/v1. אם תדביקו https://api.apisrouter.com/v1/chat/completions, SillyTavern יפנה אל /v1/chat/completions/chat/completions והחיבור ייכשל עם שגיאת 404. זה בדיוק ההפך מ-JanitorAI, שרוצה את כתובת ה-completions המלאה בהגדרות ה-proxy שלו. אותו ספק, מוסכמות שדה שונות.
למה כתובת ה-API של SillyTavern מסתיימת ב-/v1
כל API תואם OpenAI הוא כתובת בסיס בתוספת קבוצת נתיבים קבועה. GET /v1/models מחזיר את רשימת מזהי המודלים שהמפתח שלכם יכול להשתמש בהם. POST /v1/chat/completions מריץ את בקשת הצ'אט בפועל. SillyTavern מכיר את הנתיבים האלה ובונה אותם בעצמו, ולכן הוא מבקש מכם רק את הבסיס. כשלוחצים על Connect, הוא קורא ל-/v1/models עם המפתח שלכם ומשתמש בתשובה כדי למלא את רשימת המודלים. רשימה ריקה כמעט תמיד אומרת שהקריאה הזו נכשלה. אתם צריכים גם לבחור את מצב ה-API הנכון. Chat Completion שולח הודעות מובנות עם תפקידי system, user ו-assistant, וזה מה שכל ספק מתארח תואם OpenAI מצפה לו. Text Completion שולח מחרוזת prompt גולמית אחת וקיים בעיקר עבור backends מקומיים כמו KoboldCpp ו-text-generation-webui. לכל מפתח API מתארח, השתמשו ב-Chat Completion. אם תבחרו Text Completion מול endpoint צ'אט מתארח תקבלו שגיאות או פורמט שבור, וכמה מהסמפלרים המוצגים במצב הזה גם ככה לא חלים.
הגדרה שלב אחר שלב
אם הרשימה נשארת ריקה אחרי Connect, בדקו שוב שלושה דברים לפי הסדר: הכתובת מסתיימת ב-/v1 ללא נתיב נוסף וללא רווחים מיותרים, המפתח מודבק בלי מרכאות או רווחים, והמקור הוא Custom (OpenAI-compatible) ולא OpenAI רגיל. מקור OpenAI הרגיל מתעלם מהכתובת המותאמת שלכם בחלק מהגרסאות ופונה ל-api.openai.com, שם המפתח שלכם לא תקף.
- קבלו מפתח. ב-APIsRouter אין טופס הרשמה: שלמו ב-/topup והמפתח יישלח אליכם במייל. כל מפתח תואם OpenAI עובד באותו אופן בשלבים האלה.
- ב-SillyTavern, לחצו על סמל התקע כדי לפתוח את API Connections.
- הגדירו את API ל-Chat Completion.
- הגדירו את Chat Completion Source ל-Custom (OpenAI-compatible).
- ב-Custom Endpoint (Base URL), הזינו https://api.apisrouter.com/v1 בלי שום דבר אחרי /v1.
- הדביקו את המפתח שלכם בשדה Custom API Key.
- לחצו Connect. נקודת הסטטוס הופכת לירוקה ורשימת Available Models מתמלאת מ-/v1/models.
- בחרו מודל, פתחו character card, ושלחו הודעת בדיקה קצרה.
אימות החיבור מחוץ ל-SillyTavern
כשמשהו נכשל, בדקו את ה-endpoint ישירות לפני שמאשימים את SillyTavern. קריאת ה-curl הזו היא בדיוק מה שכפתור Connect עושה. אם היא מחזירה מערך JSON של מזהי מודלים, המפתח והכתובת שלכם תקינים והבעיה היא בשדות של SillyTavern. אם רשימת המודלים עובדת אבל השיחות נכשלות, הריצו completion אמיתי אחד מ-Python עם אותה כתובת בסיס. תשובה מוצלחת כאן מוכיחה את כל השרשרת, וכל הודעת שגיאה שתקבלו חזרה היא השגיאה האמיתית של הספק ולא ההודעה הגנרית של SillyTavern.
curl https://api.apisrouter.com/v1/models \
-H "Authorization: Bearer sk-your-key"יסודות סמפלרים ופריסטים
מקורות Chat Completion חושפים קבוצת סמפלרים מצומצמת: temperature, top P, frequency penalty ו-presence penalty, בתוספת אורך תשובה וגודל הקשר. סמפלרים מתוחכמים יותר שאולי קראתם עליהם (min P, mirostat, dynamic temperature) שייכים ל-backends של Text Completion ופשוט לא נשלחים ל-API-ים מתארחים של צ'אט, אז אל תחפשו אותם כאן. פריסטים ב-SillyTavern מאגדים שני דברים: ערכי סמפלר ומבנה הפרומפט ש-Prompt Manager מרכיב מה-character card, הפרסונה וה-lorebook שלכם. הפריסט המובנה Default הוא נקודת התחלה סבירה. שנו ערך אחד בכל פעם וצרו מחדש את אותה סצנה כדי לראות מה זה עושה בפועל. גודל ההקשר ראוי לתשומת לב: SillyTavern ממלא את חלון ההקשר בהיסטוריית הצ'אט, אז הקשר גדול יותר אומר יותר טוקני פרומפט שנשלחים בכל תור, מה שמשפר את הזיכרון ומעלה את העלות לכל הודעה בו זמנית.
| הגדרה | נקודת התחלה | מה זה עושה ב-roleplay |
|---|---|---|
| Temperature | 0.8 | ערך גבוה יותר (עד 1.1) נותן פרוזה מגוונת; נמוך יותר (0.6) אם הדמות סוטה מהקארד |
| Top P | 0.95 | השאירו כמו שהוא אלא אם התשובות הופכות לבלתי קוהרנטיות, ואז הורידו מעט |
| Frequency penalty | 0.1 | נלחם בקצבי משפטים חוזרים בשיחות ארוכות |
| Presence penalty | 0.05 | ערכים קטנים מונעים לולאות נושא חוזרות |
| Max response tokens | 350 | 300 עד 500 מתאים לתשובות בסגנון פסקה בלי גלישה מיותרת |
| Context size | מגבלת המודל או 16k | יותר היסטוריה לכל תור; גם יותר טוקני קלט מחויבים לכל הודעה |
מודלים מומלצים ל-SillyTavern
בחירת המודל חשובה יותר מכיוונון סמפלרים. הקונצנזוס בקהילה, ככל שדיווחים משוערים מראים, מציב את משפחת DeepSeek V4 במקום הראשון מבחינת המחיר: deepseek-v4-flash הוא ההמלצה הבסיסית לשיחות ארוכות ו-deepseek-v4-pro שומר טוב יותר על קארדים מורכבים ושיחות קבוצתיות. GLM-5, Kimi K2.6, ו-MiMo הם בחירות ערך מוצקות עם קולות פרוזה מובחנים, ששווה להחליף ביניהם כשהשיחה מתחילה להרגיש חד-גונית. Grok בולט כי המדיניות הפומבית של xAI מאפשרת במפורש נושאים בוגרים בהקשרים בדיוניים, מה שחשוב לעלילות אפלות יותר. Claude כותב את הפרוזה הטובה ביותר מכל מה שברשימה הזו, אבל מדיניות Anthropic אוסרת תוכן מפורש, אז התייחסו ל-Claude כבחירה לכתיבה יצירתית SFW ולסצנות בסגנון ספרותי. שתי הערות מעשיות. ראשית, SillyTavern היא תוכנה המיועדת למבוגרים, וכל מודל כאן אוכף את מדיניות התוכן של הספק שלו ללא קשר ל-frontend שלכם, אז שמרו על קארדים וסצנות בתוך הכללים האלה. שנית, מכיוון שהרשימה מתמלאת בזמן אמת מ-/v1/models, אתם יכולים להחליף מודלים באמצע שיחה ולהשוות תשובות לאותה הודעה, וזו הדרך המהירה ביותר למצוא את המועדף עליכם.
| מזהה מודל | חוזק ב-SillyTavern | הערות מדיניות תוכן |
|---|---|---|
| deepseek-v4-flash | המועדף על הקהילה לשיחות ארוכות; הערך הטוב ביותר להודעה | מדיניות גמישה לבדיון; עוקב היטב אחרי character cards |
| deepseek-v4-pro | ציות חזק יותר להוראות עבור קארדים מורכבים ושיחות קבוצתיות | אותה משפחה כמו Flash עם קוהרנטיות טובה יותר |
| glm-5 | קול פרוזה מובחן; קצב טוב בסצנות איטיות | בחירת ערך לשיחות עתירות נרטיב |
| kimi-k2.6 | זכירת הקשר ארוך ל-lorebooks גדולים | בחירת ערך; מטפל בקארדים גדולים בלי לשכוח |
| grok-4.5 | אימפרוביזציה וחילופי דברים חזקים | מדיניות xAI מאפשרת נושאים בוגרים בהקשרים בדיוניים |
| claude-sonnet-4-6 | איכות הפרוזה הגבוהה ביותר תמורת הכסף | כתיבה יצירתית SFW בלבד; Anthropic אוסרת תוכן מפורש |
| claude-opus-4-7 | הכתיבה הספרותית הארוכה הטובה ביותר | אותה מדיניות SFW-בלבד כמו Sonnet |
| gemini-3.5-flash | תשובות מהירות, הקשר ארוך | מדיניות Google סטנדרטית; טוב ל-RP בסגנון הרפתקאות |
כמה שיחות SillyTavern באמת עולות
מודלים מתארחים מחייבים לפי טוקן, ו-roleplay עתיר קלט: כל תור שולח מחדש את character card בתוספת ההיסטוריה האחרונה. תור ששולח 8,000 טוקני פרומפט ומקבל תשובה של 350 טוקנים עולה בערך עשירית מהסנט על deepseek-v4-flash, כך שכמה דולרים מכסים חודשים של צ'אט מזדמן. אותו תור על claude-opus-4-7 עולה בערך פי 25 יותר, ולכן רוב האנשים מריצים מודל יומיומי זול ושומרים מודלים פרימיום לסצנות שחשובות להם. מפתח gateway אחד מכסה את כל הטבלה הזו. APIsRouter הוא gateway תואם OpenAI עם חיוב לפי שימוש בפועל ובלי מנוי: אתם משלמים ב-/topup בלי ליצור חשבון, המפתח מגיע במייל, הטענה הראשונה שלכם מוסיפה +100% תואם ליתרה שלכם, מודלים גלובליים מתומחרים 20% מתחת למחירים הרשמיים, ומודלים סיניים יושבים מתחת למחירים הרשמיים שלהם.
| מודל | קלט / 1M טוקנים | פלט / 1M טוקנים |
|---|---|---|
| deepseek-v4-flash | $0.126 | $0.252 |
| deepseek-v4-pro | $0.3915 | $0.783 |
| glm-5 | $0.514 | $2.314 |
| gemini-3.5-flash | $1.20 | $7.20 |
| claude-sonnet-4-6 | $2.40 | $12.00 |
| claude-opus-4-7 | $4.00 | $20.00 |
| gpt-5.5 | $4.00 | $24.00 |
| grok-4.5 | $1.60 | $4.80 |
שאלות נפוצות
איזו כתובת API אני שם ב-SillyTavern?
רק כתובת הבסיס, שמסתיימת ב-/v1. עבור APIsRouter זו https://api.apisrouter.com/v1. SillyTavern מוסיף בעצמו את /chat/completions, אז הזנת הנתיב המלא של completions שוברת את החיבור עם שגיאת 404.
האם יש API חינמי ל-SillyTavern?
SillyTavern עצמו הוא תוכנת קוד פתוח חינמית. גישה למודלים מתארחים מחויבת לפי טוקן, אם כי כמה ספקים מציעים שכבות חינמיות עם מגבלות קצב ותורים הדוקים. הרצת מודל מקומי דרך KoboldCpp היא חינמית אם החומרה שלכם מסוגלת לזה. בפועל, מודלים מתארחים זולים כמו deepseek-v4-flash עולים שבריר סנט להודעה, וזה קרוב מספיק לחינם לשימוש מזדמן בלי הכאב של מגבלות הקצב.
למה רשימת המודלים שלי ב-SillyTavern ריקה?
קריאת ה-Connect אל /v1/models נכשלה. בדקו שהכתובת מסתיימת ב-/v1 בלי נתיב נוסף או רווחים, שהמפתח מודבק נקי, ושהמקור הוא Custom (OpenAI-compatible) ולא OpenAI רגיל. בדקו עם curl מול /v1/models כדי לראות את השגיאה האמיתית של הספק.
האם כדאי להשתמש ב-Chat Completion או ב-Text Completion ב-SillyTavern?
Chat Completion לכל API מתארח תואם OpenAI. Text Completion מיועד ל-backends מקומיים כמו KoboldCpp ו-text-generation-webui שמקבלים מחרוזת prompt גולמית. בחירת Text Completion מול endpoint צ'אט מתארח גורמת לשגיאות או לפורמט שבור.
איזה מודל הכי טוב ל-roleplay ב-SillyTavern?
התחילו עם deepseek-v4-flash, ברירת המחדל הנפוצה בקהילה לשיחות ארוכות בעלות נמוכה. עברו ל-deepseek-v4-pro עבור קארדים מורכבים, נסו את GLM-5 או Kimi K2.6 לקול פרוזה אחר, והשתמשו ב-Claude לכתיבה יצירתית SFW באיכות הגבוהה ביותר. Grok מתאים לנושאים בדיוניים בוגרים תחת המדיניות הפומבית של xAI.
האם מפתח ה-API שלי בטוח ב-SillyTavern?
המפתחות נשמרים מקומית בקובץ secrets.json של SillyTavern על המחשב שלכם ונשלחים רק ל-host ה-API שהגדרתם. אל תשתפו צילומי מסך של פאנל החיבור או קבצי הגדרות מיוצאים, והחליפו את המפתח אם אתם חושדים שהוא דלף.