# מפתחות ספק

> הוסיפו ל-Nodaro באירוח עצמי מפתחות של ספקי מודלים בדף ‎/setup או בקובץ ‎.env, ראו מה כל מפתח מאפשר והעבירו את התעבורה לספקים דרך פרוקסי.

Source: https://nodaro.ai/he/docs/self-hosting/provider-keys

**מפתחות ספק** הם מפתחות ה-API שמאפשרים ל-Nodaro באירוח עצמי לקרוא למודלי AI. אפשר להדביק אותם באפליקציה או להגדיר אותם בסביבה, ושתי הדרכים פעילות במקביל. במקום מפתחות, או לצידם, אפשר גם לחבר את ההתקנה לחשבון Nodaro Cloud: ראו את הדף [חיבור ל-Nodaro Cloud](https://nodaro.ai/docs/self-hosting/cloud-connect).

## שתי דרכים להוסיף מפתח
| דרך | איפה המפתח נשמר | מתי הוא נכנס לתוקף | מי יכול לשנות אותו |
| --- | --- | --- | --- |
| **הדבקה באפליקציה**, בדף `/setup` במקטע **תקינות ההתקנה**, או תחת **אינטגרציות › ספקי מודלים** | במסד הנתונים שלכם, מוצפן במפתח של המופע. אף נתיב לא מחזיר אותו. | מיד. ה-API משתמש בו כבר באותו רגע, וה-workers קוראים אותו בתוך כ-30 שניות. בלי הפעלה מחדש. | במהדורת Community: כל משתמש מחובר. במהדורת Business: המנהלים. |
| **הגדרה בסביבה**, בקובץ `.env` או במשתנים של הפלטפורמה שלכם | בסביבה שלכם | בהפעלה הבאה | מי שמנהל את השרת |

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

הדבקת מפתח דורשת תמיד סשן מחובר באפליקציה. אסימון API או אסימון אפליקציה אף פעם לא יכולים לשנות מפתח. כרטיסי התקינות בדף `/setup` לא דורשים התחברות, אבל שמירת מפתח שם כן דורשת: השלימו קודם את שלב 1, **יצירת פרטי ההתחברות לשרת**.

## איזה מפתח גובר
**הסביבה גוברת.** מפתח שהוגדר בסביבה הוא לקריאה בלבד במסך: האריח שלו מציג `set (env)` ומציין את המשתנה שצריך להסיר. מפתח שהודבק משמש רק כשאין בסביבה מפתח לאותו ספק.

## ניהול מפתח באריח שלו
אפשר לנהל כל אריח ספק בזמן ריצה, כולל מפתחות שמגיעים מהקובץ `.env`. השינויים נכנסים לתוקף בלי הפעלה מחדש.

- **מפתח שהודבק** מציג `set (app)`, או `key set (app)` באריח **nodaro.ai**. אפשר ללחוץ על **שינוי מפתח** או על **הסרה** בכל רגע.
- **מפתח מהקובץ `.env`**: אי אפשר לערוך אותו במקום. הכפתור **החלפת מפתח ‎.env** שומר באפליקציה מפתח שעוקף את המפתח מהסביבה, בלי לערוך את הקובץ. אפשר גם להסיר את המפתח מהקובץ `.env` ולהפעיל מחדש.
- הכפתור **השבתה** מפסיק את השימוש בספק עד שתפעילו אותו שוב, בין שהמפתח שלו הגיע מהקובץ `.env` ובין שהודבק. כך אפשר להעביר את היצירה לספק אחר, למשל לחיבור שלכם ל-Nodaro Cloud.
- המצב **`missing`** (בדף **אינטגרציות**: ״חסר״) פירושו שלספק אין מפתח. המצב **`disabled`** (״מושבת״) פירושו שהשבתתם אותו.

כל אריח מציין במה המפתח שלו משמש ואיפה אפשר להשיג מפתח כזה.

## כל מפתחות הספק
| משתנה | מה הוא מאפשר |
| --- | --- |
| `NODARO_API_KEY` | Nodaro Cloud כספק: אסימון API אישי מ-app.nodaro.ai › **הגדרות › מפתחות API**, והחיוב לאותו חשבון. ראו את הדף [חיבור ל-Nodaro Cloud](https://nodaro.ai/docs/self-hosting/cloud-connect#or-use-an-api-key-like-any-other-provider). |
| `KIE_API_KEY` | הכיסוי הרחב ביותר של מודלים: מודלי תמונה, וידאו, אודיו וטקסט, כולל רכיבי המוזיקה של Suno. |
| `REPLICATE_API_TOKEN` | ספק חלופי עם קטלוג משלו, כולל מודלי Flux 2. |
| `ANTHROPIC_API_KEY` | מודלי Claude לרכיבי הטקסט, בקריאה ישירה. |
| `GEMINI_API_KEY` | מודלי Gemini, בקריאה ישירה. מפתח של Google AI Studio. ראו את הסעיף [מודלי Gemini](#gemini-models). |
| `ELEVENLABS_API_KEY` | דיבור, קולות, דיבוב, משנה קול ויישור מאולץ. |
| `FAL_KEY` | אופציונלי. מודלים כמו [Sync Lipsync v3](https://nodaro.ai/docs/models/video/sync-lipsync-v3). בלעדיו, המודלים האלה לא זמינים, ושום דבר אחר לא משתנה. |

### מפתחות לרכיבים מסוימים
השאירו את המפתחות האלה ריקים, אלא אם אתם משתמשים ברכיב שהם מציינים. בהתקנה מחוברת, הרכיבים האלה רצים דרך Nodaro Cloud כשהמפתח שלהם ריק.

| משתנה | רכיבים |
| --- | --- |
| `HEYGEN_API_KEY` | [אווטאר AI](https://nodaro.ai/docs/nodes/video/ai-avatar) ו[אווטאר קולנועי](https://nodaro.ai/docs/nodes/video/cinematic-avatar) |
| `BEEBLE_API_KEY` | [תאורה מחדש והחלפה](https://nodaro.ai/docs/nodes/video/relight-and-switch) |
| `APIFY_API_TOKEN` | [גריפת אתר](https://nodaro.ai/docs/nodes/automate/web-scrape), [צילום אתר](https://nodaro.ai/docs/nodes/automate/site-capture) ו[מודעות Meta](https://nodaro.ai/docs/nodes/automate/meta-ads) |

המשתנה `GEMINI_API_KEY` שונה מ-`GOOGLE_CLIENT_ID` ומ-`GOOGLE_CLIENT_SECRET`. שני אלה שייכים לאפליקציית OAuth של Google, למשל לפרסום ביוטיוב. ראו את הסעיף [אפליקציות לרשתות חברתיות](https://nodaro.ai/docs/self-hosting/configuration#social-network-apps) בדף תצורה.

## מפתחות והחיבור ל-Nodaro Cloud
- **חיבור מכסה את כל האריחים.** בהתקנה מחוברת, מודלי תמונה, וידאו, דיבור וטקסט, האווטארים, רכיב תאורה מחדש והחלפה וגריפת האתרים רצים דרך חשבון ה-Nodaro Cloud שלכם. הדביקו מפתח רק כדי לקרוא לספק הזה ישירות.
- **אתם בוחרים מי גובר.** כשמחברים את ההתקנה, תיבת דו־שיח שואלת אם Nodaro Cloud מריץ הכול קודם או שהמפתחות שלכם רצים קודם. ראו את הסעיף [בחירת אופן השימוש בחיבור](https://nodaro.ai/docs/self-hosting/cloud-connect#choose-how-the-connection-is-used) בדף חיבור ל-Nodaro Cloud.
- **חיבור ה-OAuth גובר על `NODARO_API_KEY`.** כשבהתקנה מוגדרים שניהם, היא משתמשת בחיבור ומתעלמת מהמפתח.

## מודלי Gemini
מודלי Gemini יכולים לרוץ בשתי דרכים. בלי `GEMINI_API_KEY`, הם רצים על `KIE_API_KEY`. עם המפתח:

- **Gemini 3.1 Pro** רץ קודם ישירות אצל Google, והמפתח `KIE_API_KEY` משמש כחלופה.
- **מודלי Gemini Flash** נשארים על `KIE_API_KEY` ומשתמשים ב-`GEMINI_API_KEY` רק כשהקריאה דרך `KIE_API_KEY` נכשלת.
- **Gemini 4 Argon** רץ רק אצל Google, עם `GEMINI_API_KEY`. אין לו חלופה: בלי המפתח, ההרצות שלו נכשלות עם השגיאה "provider unavailable" (הספק לא זמין).

שני דברים שכדאי לדעת לפני שמגדירים אותו:

- **עלות.** Google גובה על המסלול הישיר את המחירים שלו לכל טוקן, ואלה יכולים להיות גבוהים מהמחיר של אותו מודל דרך `KIE_API_KEY`. בדקו את המחירים העדכניים של Google לפני שאתם מעבירים מודל שמשתמשים בו בהיקף גדול.
- **מדיה.** ה-API של Google לא יכול לטעון כתובות URL שרירותיות. Nodaro מוריד כל ייחוס של תמונה, וידאו או אודיו ושולח אותו כנתונים בתוך הבקשה כשהוא קטן, או דרך ה-Files API של Gemini כשהוא גדול. ה-Files API שומר קבצים למשך 48 שעות.

## העברת התעבורה לספקים דרך פרוקסי משלכם
בשני ספקים אפשר לשנות את המארח, ולא רק את המפתח:

| משתנה | ברירת מחדל | מה הוא מעביר |
| --- | --- | --- |
| `KIE_API_BASE_URL` | מארח ה-API של הספק עצמו | כל קריאה שנעשית עם `KIE_API_KEY`: יצירת מדיה **וגם** תעבורת הטקסט של Claude ו-Gemini שרצה עליו |
| `ELEVENLABS_BASE_URL` | `https://api.elevenlabs.io` | כל קריאה ל-ElevenLabs: טקסט לדיבור, דיבור לטקסט, קולות, שיבוט, דיבוב ויישור מאולץ |

כשהשניים לא מוגדרים, שום דבר לא משתנה. כשמגדירים אחד מהם, Nodaro פונה למארח שלכם במקום למארח של הספק. הסיבות הנפוצות הן משמורת מפתחות (המפתח האמיתי נשמר רק בפרוקסי), יומן ביקורת של כל יצירה שיוצאת מהשרת וניתוב אזורי.

הפרוקסי שלכם חייב להיות שקוף: אותם נתיבים ואותו גוף בקשה ותגובה, כי Nodaro מחליף רק את ה-origin. לוכסנים בסוף מוסרים, ולכן `https://proxy.example.com/models/` ו-`https://proxy.example.com/models` מתנהגים אותו דבר.

**KIE_API_BASE_URL מעביר גם את תעבורת מודלי הטקסט:** 
התעבורה של Claude ו-Gemini שמאחורי שיפור הפרומפט, יצירת התסריטים ושאר יכולות הטקסט עוברת דרך אותו מארח. הפרוקסי שלכם חייב להעביר את הנתיבים האלה, ולא רק את ה-API של המדיה:

- `/api/v1/...`, למשימות, לתשאול ולבדיקת היתרה
- `/claude/v1/messages`
- `/<family>/v1/chat/completions`
- `/<family>/v1/responses`
- `/client/v1/userRecord/...`, לבדיקות הקרדיטים

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

הפרוקסי לא משפיע על `ANTHROPIC_API_KEY` ועל `GEMINI_API_KEY`. איתם, המודלים האלה קוראים ישירות ל-Anthropic ול-Google.

## בדיקה שמפתח עובד
- **בעורך.** פתחו את תהליך ההדגמה **Welcome Demo** ולחצו על **הרצה** ברכיב **תמונת הסצנה** שלו.
- **משורת הפקודה.** הריצו את סקריפט הבדיקה עם `--keyed`. הסקריפט מריץ יצירה אמיתית אחת, בתשלום, במודל הזול ביותר של `KIE_API_KEY` או של `REPLICATE_API_TOKEN` שלכם, ובודק שהמדיה מגיעה לאחסון שלכם:

```bash
node tools/community-smoke.mjs http://localhost:3000 --keyed
```

רכיב שנכשל עם `Missing API key` (חסר מפתח API) קורא לספק שאין לו מפתח. הוסיפו את המפתח של הספק הזה בדף `/setup` או בקובץ `.env`.

## מפתח ההצפנה
מפתחות שהודבקו צריכים את מפתח ההצפנה של המופע, `NODARO_ENCRYPTION_KEY`. מערך השירותים המובנה של Compose יוצר אותו באתחול הראשון. בלי מפתח כזה, האריחים מציגים `missing`, והדף `/setup` מציג כרטיס **הצפנה** אדום עם הפתרון. מפתחות שהוגדרו בסביבה ממשיכים לעבוד. ראו את הדף [התקנה](https://nodaro.ai/docs/self-hosting/install#2-generate-the-internal-secrets).

## שאלות נפוצות

### איפה מוסיפים מפתחות ספק ב-Nodaro באירוח עצמי?

את מפתחות הספק מדביקים בדף ‎/setup, במקטע תקינות ההתקנה, או באפליקציה תחת אינטגרציות › ספקי מודלים. אפשר גם להגדיר אותם בקובץ ‎.env ולהריץ docker compose up -d. מפתחות שהודבקו נכנסים לתוקף מיד, בלי הפעלה מחדש.

### מה גובר: מפתח בקובץ ‎.env או מפתח שהודבק במסך?

המפתח שבסביבה גובר. האריח שלו מציג set (env), ואי אפשר לערוך אותו במקום. הסירו אותו מהקובץ ‎.env והפעילו מחדש, או לחצו באריח על הכפתור החלפת מפתח ‎.env כדי לעקוף אותו מהמסך.

### מי יכול לשנות את מפתחות הספק?

במהדורת Community, כל משתמש מחובר יכול לשנות את מפתחות הספק, כי המהדורה מיועדת למנהל שרת יחיד. במהדורת Business, רק המנהלים. אסימוני API ואסימוני אפליקציה אף פעם לא יכולים לשנות אותם.

### איפה נשמרים מפתחות שהודבקו?

מפתחות שהודבקו נשמרים במסד הנתונים שלכם, מוצפנים ב-AES-256-GCM עם מפתח ההצפנה של המופע. אף נתיב לא מחזיר אותם. בלי מפתח הצפנה, האריחים מציגים missing, והדף ‎/setup מציג כרטיס הצפנה אדום.

### למה תמונה ווידאו עובדים, אבל כל יכולות הטקסט נכשלות?

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