# אודיו

> צרו דיבור ודיאלוג, עצבו והחליפו קולות, דבבו, צרו אפקטי קול, תמללו ונקו או קצצו אודיו עם כלי האודיו של Nodaro ב-MCP.

Source: https://nodaro.ai/he/docs/mcp/tools/audio

**כלי האודיו** מאפשרים לעוזר AI ליצור ולשנות סאונד ב-Nodaro: דיבור ודיאלוג, קולות חדשים וקולות שהוחלפו, דיבוב, אפקטי קול, תמלולים וניקוי. כל כלי חוץ מ-`list_voices` מתחיל משימה ומחזיר את המזהה שלה, והתוצאה נשמרת בספרייה שלכם. כל כלי אודיו צריך את ההרשאה `workflows:execute`.

| כלי | מה הוא עושה |
| --- | --- |
| [`generate_speech`](#generate_speech) | טקסט לדיבור בקול שבוחרים |
| [`generate_dialogue`](#generate_dialogue) | שיחה בין כמה קולות, כקובץ אחד |
| [`list_voices`](#list_voices) | הקולות המוכנים מראש |
| [`voice_design`](#voice_design) | קול חדש מתיאור |
| [`voice_remix`](#voice_remix) | דיבור בקול שמתארים במילים, בלי מזהה קול |
| [`voice_changer`](#voice_changer) | מחליף את הקול בהקלטה או בסרטון |
| [`voice_changer_pro`](#voice_changer_pro) | מחליף בבת אחת את הקולות של כמה דוברים |
| [`dubbing`](#dubbing) | מתרגם דיבור לשפה אחרת ושומר על הקולות |
| [`text_to_audio`](#text_to_audio) | אפקטי קול מתיאור |
| [`transcribe`](#transcribe) | דיבור לטקסט, עם תזמוני מילים |
| [`audio_isolation`](#audio_isolation) | מבודד את הקול או הצליל העיקרי ממיקס |
| [`separate_audio`](#separate_audio) | מפצל אודיו לשירה ולכלים, או לסטמים |
| [`apply_audio_fx`](#apply_audio_fx) | ריוורב ואפקטים שממקמים קול בחלל |
| [`pitch_tempo`](#pitch_tempo) | משנה את גובה הצליל, או את הטמפו בלי לשנות את גובה הצליל |
| [`trim_audio`](#trim_audio) | מקצץ אודיו, או מחלץ אותו מסרטון |
| [`mix_audio`](#mix_audio) | משלב 2–20 רצועות בשכבות לקובץ אחד, עם מוזיקת רקע שיורדת בעוצמה מתחת לקול |
| [`download_youtube_audio`](#download_youtube_audio) | רצועת האודיו של סרטון יוטיוב |

## `generate_speech`
הופך טקסט לדיבור בקול של ElevenLabs. הכלי עובד כמו רכיב [טקסט לדיבור](https://nodaro.ai/docs/nodes/audio/text-to-speech).

**הרשאה:** `workflows:execute`. **קרדיטים:** המחיר של המודל, בטבלה שלמטה.

| Model | Maker | Modes | Credits | Details |
| --- | --- | --- | --- | --- |
| [ElevenLabs v4](https://nodaro.ai/docs/models/audio/elevenlabs-v4) | ElevenLabs | Text to speech | החל מ-5 | Newest ElevenLabs TTS — [audio tags], stability and similarity control, up to 10,000 characters per request. Direct API. |
| [ElevenLabs v4 Turbo](https://nodaro.ai/docs/models/audio/elevenlabs-v4-turbo) | ElevenLabs | Text to speech | החל מ-3 | Faster, cheaper ElevenLabs v4 at lower fidelity — [audio tags], stability and similarity control, at Turbo's credit price. Prefer v4 when quality matters. Direct API. |
| [ElevenLabs v3](https://nodaro.ai/docs/models/audio/elevenlabs-v3) | ElevenLabs | Text to speech | החל מ-5 | Expressive ElevenLabs TTS — supports [audio tags] for emotion / pacing. Direct API. |
| [ElevenLabs Turbo v2.5](https://nodaro.ai/docs/models/audio/elevenlabs-turbo-v2-5) | ElevenLabs | Text to speech | החל מ-3 | Fast, cheap ElevenLabs TTS via the direct ElevenLabs API. Good for narration. |
| [ElevenLabs Multilingual v2](https://nodaro.ai/docs/models/audio/elevenlabs-multilingual-v2) | ElevenLabs | Text to speech | החל מ-5 | Multi-language ElevenLabs TTS via the direct ElevenLabs API. |

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `text` | string | **נדרש.** מה להגיד, עד 10,000 תווים ולא יותר מהמגבלה של המודל שנבחר: 5,000 ב-ElevenLabs v3. טקסט ארוך יותר נדחה, ולא נחתך. פצלו תסריט ארוך יותר לכמה קריאות. |
| `voice_id` | string | שם של קול מוכן מראש, או המזהה של קול ששכפלתם. ברירת המחדל: `Rachel`. קריאה עם שם לא מוכר נכשלת. מזהה לא מוכר מוחלף ב-Rachel, כדי שהעוזר יקבל אודיו בכל זאת. כשהפרמטר `voice_type` הוא `custom` או `library`, מזהה לא מוכר לא מוחלף, והקריאה נכשלת. |
| `voice_type` | string | `premade`, `custom` או `library`. |
| `model` | string | `elevenlabs-v4` (ברירת המחדל), `elevenlabs-v4-turbo`, `elevenlabs-v3`, `elevenlabs-turbo` או `elevenlabs-multilingual`. גם `elevenlabs`, המזהה הישן של `elevenlabs-turbo`, מתקבל. |
| `language_code` | string | השפה של הטקסט. |
| `stability`, `similarity_boost`, `style` | number | הגדרות הגשה, מ-0 עד 1. |
| `speed` | number | מ-0.7 עד 1.2. |
| `previous_text` | string | השורה שנאמרת ממש לפני השורה הזו, כהקשר להגשה רציפה בין קליפים. היא לא מוקראת. עד 1,000 תווים. ElevenLabs v3 מתעלם ממנה. |
| `next_text` | string | השורה שנאמרת מיד אחרי השורה הזו, ואותו כלל חל עליה כמו על `previous_text`. |
| `presetId` | string | ערכת הגשה, כגון **קריין רגוע**, **קריאת פרסומת** או **ספר מוקלט**, מ-[`list_node_presets`](https://nodaro.ai/docs/mcp/tools/models-and-credits#list_node_presets). עדיין צריך להעביר `text`. |

**בחירת מודל.** ElevenLabs v4, ברירת המחדל, תומך בתגי אודיו כגון `[laughs]` (צוחק), `[whispers]` (לוחש) ו-`[sighs]` (נאנח), לרגש ולקצב, והוא רב־לשוני לגמרי: השתמשו בו לכל שפה, כולל עברית, ערבית, סינית, יפנית וקוריאנית. הוא מקבל את `stability` ואת `similarity_boost`, אבל לא את `speed` או את `style`. ElevenLabs v3 הוא המודל הקודם, עם אותם תגים ועם `stability` בלבד. ElevenLabs v4 Turbo הוא גרסה מהירה יותר של v4, במחיר של Turbo. ElevenLabs Turbo זול יותר לקריינות פשוטה. ElevenLabs Multilingual v2 הוא מודל מדור קודם; השתמשו בו רק לקול שידוע שהוא עובד רק ב-v2.

**בחירת קול.** הקולות המוכנים מראש הם Rachel, Aria, Roger, Sarah, Laura, Charlie, George, Callum, River, Liam, Charlotte, Alice, Matilda, Will, Jessica, Eric, Chris, Brian, Daniel, Lily ו-Bill. לקול נשי חם נסו את Rachel, לקול נשי צעיר את Aria או את Lily, לקול גברי עמוק את Roger או את Brian, לקול גברי ניטרלי את George או את Daniel, ולקול בריטי את Charlie או את Charlotte.

**מה חוזר:** מזהה משימה. הכרטיס מנגן את האודיו כשהוא מוכן.

## `generate_dialogue`
מקריא תסריט של כמה דוברים כקובץ אודיו אחד, שבו הדוברים מתחלפים באופן טבעי, ב-ElevenLabs Dialogue v3 או ב-ElevenLabs Dialogue v4. השתמשו בו לשיחות, לראיונות, לדיאלוגים בסגנון פודקאסט ולסצנות, במקום לאחד קליפים נפרדים של `generate_speech`. הכלי עובד כמו רכיב [טקסט לדיאלוג](https://nodaro.ai/docs/nodes/audio/text-to-dialogue).

**הרשאה:** `workflows:execute`. **קרדיטים:** המחיר של [ElevenLabs Dialogue v3](https://nodaro.ai/docs/models/audio/elevenlabs-dialogue-v3) או של [ElevenLabs Dialogue v4](https://nodaro.ai/docs/models/audio/elevenlabs-dialogue-v4), לכל 100 תווים של התסריט, או חלק מהם, עם מינימום של 8 יחידות.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `model` | string | `elevenlabs-dialogue` (Dialogue v3, ברירת המחדל) או `elevenlabs-dialogue-v4`. |
| `dialogue` | array | **נדרש.** השורות לפי סדר הדיבור, 1–200, כל אחת בצורה `{ text, voice_id }`. השתמשו באותו קול לאותה דמות. השורות יכולות לכלול תגי אודיו כגון `[laughs]` (צוחק). |
| `stability` | number | ב-Dialogue v3: `0` (המשתנה ביותר), `0.5` (מאוזן) או `1` (היציב ביותר). ב-Dialogue v4: כל ערך מ-0 עד 1. |
| `similarity_boost` | number | ב-Dialogue v4 בלבד. עד כמה כל שורה שומרת על האופי של הקול שלה, מ-0 עד 1. |
| `language_code` | string | רמז לשפה, כגון `en` או `he`. השמיטו אותו כדי שהשפה תזוהה אוטומטית. |
| `seed` | integer | זרע קבוע לתוצאה שאפשר לשחזר. |
| `apply_text_normalization` | string | כותב מספרים, תאריכים וקיצורים כמילים מלאות: `auto` (ברירת המחדל), `on` או `off`. |

המגבלות הן 5,000 תווים בסך הכול ב-Dialogue v3 ו-10,000 ב-Dialogue v4, עם המלצה על 2,000 או פחות לאיכות הטובה ביותר, ו-10 קולות שונים בכל קריאה. אפשר לשלב באותו תסריט קולות מוכנים מראש, לפי השם שלהם, וקולות ששכפלתם.

**מה חוזר:** מזהה משימה.

## `list_voices`
מחזיר את הקולות המוכנים מראש, עם המזהה, השם ופרטי מגדר, מבטא ותיאור, כשהם קיימים. הכלים `generate_speech`, `voice_changer` ו-`voice_changer_pro` צריכים מזהה קול.

**הרשאה:** `workflows:execute`. **קרדיטים:** חינם.

לכלי הזה אין פרמטרים. הוא קורא את הקטלוג ולא מתחיל משימה.

## `voice_design`
מעצב קול חדש מתיאור ומחזיר דוגמה שבה הקול מקריא את התסריט שלכם. השתמשו בו כדי לשמוע קול לפני שאתם שומרים אותו. הכלי עובד כמו רכיב [עיצוב קול](https://nodaro.ai/docs/nodes/audio/voice-design).

**הרשאה:** `workflows:execute`. **קרדיטים:** 55.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `voice_description` | string | **נדרש.** הקול: מגדר, גיל, מבטא, טון ואופי, עד 1,000 תווים. למשל "warm female narrator with a soft British accent, low-pitched, calm pacing" (קריינית חמה עם מבטא בריטי רך, קול נמוך וקצב רגוע). |
| `text` | string | **נדרש.** תסריט לדוגמה שהקול יקריא, בין 100 ל-1,000 תווים. |
| `model` | string | `eleven_ttv_v3` (ברירת המחדל, לכל שפה) או `eleven_multilingual_ttv_v2`, מדור קודם. |
| `loudness`, `guidance_scale`, `quality`, `seed`, `should_enhance` | | הגדרות עיצוב אופציונליות. הערך של `loudness` הוא מ-`-1` עד 1, ושל `guidance_scale` מ-0 עד 100. |

**מה חוזר:** מזהה משימה. התוצאה היא דוגמת אודיו של הקול שעוצב.

## `voice_remix`
מקריא טקסט בקול שאתם מתארים במילים, בלי מזהה קול. השתמשו בו לקול חד־פעמי שלא צריך לשמור. הכלי עובד כמו רכיב [רמיקס קול](https://nodaro.ai/docs/nodes/audio/voice-remix).

**הרשאה:** `workflows:execute`. **קרדיטים:** 44.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `text` | string | **נדרש.** מה להגיד, עד 5,000 תווים. |
| `voice_description` | string | **נדרש.** הקול, עד 1,000 תווים, למשל "a warm, mid-40s British woman with a calm news-anchor tone" (אישה בריטית חמה באמצע שנות ה-40 לחייה, עם טון רגוע של מגישת חדשות). |

**מה חוזר:** מזהה משימה.

## `voice_changer`
מחליף את הקול ברצועת אודיו, או בסרטון שלם שמדברים בו, ושומר על ההגשה ועל הקצב. הכלי עובד כמו רכיב [משנה קול](https://nodaro.ai/docs/nodes/audio/voice-changer).

**הרשאה:** `workflows:execute`. **קרדיטים:** 44.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `voice_id` | string | **נדרש.** הקול החדש: שם של קול מוכן מראש, או המזהה של קול ששכפלתם. |
| `audio_url` או `audio_asset_id` | string | מקור אודיו. |
| `video_url` או `video_asset_id` | string | מקור וידאו, במקום מקור אודיו. כשמעבירים את שניהם, הווידאו גובר. |
| `remove_background_noise` | boolean | הערך `true` מחזיר קול נקי בלבד. הערך `false` שומר את המוזיקה ואת אפקטי הקול מתחת לקול החדש. |
| `stability`, `similarity_boost`, `style` | number | מ-0 עד 1. הפרמטר `style` מעצים את ההגשה המקורית; מעל 0 ההחלפה איטית יותר ועלולה להיות פחות יציבה. |

**מה חוזר:** מזהה משימה. כשהמקור הוא סרטון, הכרטיס מאפשר להאזין לאודיו החדש, והסרטון החדש נשמר בספרייה שלכם.

## `voice_changer_pro`
מזהה כל דובר בקליפ ונותן לכל אחד קול חדש, ושומר על המילים ועל התזמון. דובר 1 מקבל את הקול הראשון ברשימה, דובר 2 את השני, וכן הלאה, לפי הסדר שבו הדוברים מדברים לראשונה. הכלי עובד כמו רכיב [משנה קול Pro](https://nodaro.ai/docs/nodes/audio/voice-changer-pro).

**הרשאה:** `workflows:execute`. **קרדיטים:** כמו ברכיב משנה קול Pro. **ב-Nodaro Cloud בלבד.**

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `ordered_voices` | array | **נדרש.** 1–8 פריטים, אחד לכל דובר. פריט הוא מזהה קול, אובייקט עם הגדרות משלו, או `null` כדי לשמור על הקול של אותו דובר. לפחות פריט אחד צריך להיות שונה מ-`null`. |
| `audio_url`, `audio_asset_id`, `video_url` או `video_asset_id` | string | המקור: רצועת אודיו, או סרטון שהקולות בו מוחלפים. |
| `analysis` | object | הפלט של משימת `voice_changer_pro_analyze` קודמת. ההחלפה משתמשת אז בדיוק ברשימת הדוברים שמיפיתם אליה את הקולות שלכם, במקום לזהות את הדוברים מחדש. |
| `preserve_background` | boolean | מחזיר למיקס את המוזיקה ואת אפקטי הקול, מתחת לקולות החדשים. ברירת המחדל: `true`. |
| `music_volume_mode`, `music_volume` | | העוצמה של הרקע: `match` (כמו במקור), `normalize` או `manual` עם עוצמה מ-0 עד 200. |
| `voice_fx` | object | ריוורב או אפקט על הקולות החדשים, לפני שהרקע חוזר: השדה `preset`, כגון `room`, `hall`, `church`, `telephone` או `echo`, עם `wetDryMix`, `delayMs` ו-`decay`. |
| `separation_quality` | string | `fast` (ברירת המחדל) או `best`. |
| `remove_background_noise` | boolean | מסיר קודם רעשי רקע, לתוצאה נקייה של קול בלבד. |
| `output` | string | `video` (ברירת המחדל), סרטון מוגמר, או `stems`, הרצועות הנפרדות, למיקס משלכם עם `voice_changer_pro_export`. |
| `model` | string | מודל קול במקום ברירת המחדל. |

אובייקט של פריט קול מקבל `voiceId`, ובאופן אופציונלי גם `engine`, `stability`, `similarityBoost`, `style`, `useSpeakerBoost`, `seed`, `volumeMode` ו-`volume`. הערך של `engine` הוא `sts` (ברירת המחדל, שמחליף את הקול בביצוע המקורי), `v3` או `v4`. המנועים `v3` ו-`v4` מקריאים מחדש את השורה מהתמלול שלה עם ElevenLabs v3 או ElevenLabs v4, ומקבלים תגי אודיו. המנוע `v3` מקבל יציבות של 0, 0.5 או 1. המנוע `v4` מקבל כל ערך יציבות מ-0 עד 1, ומחיל את `similarityBoost`. שני המנועים קוראים את התמלול מה-`analysis`; בלי ניתוח, הם משתמשים בתמלול משלהם.

**מה חוזר:** מזהה משימה.

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

**הרשאה:** `workflows:execute`. **ב-Nodaro Cloud בלבד.**

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `audio_url`, `audio_asset_id`, `video_url` או `video_asset_id` | string | קליפ המקור. |
| `separation_quality` | string | `fast` (ברירת המחדל) או `best`. |
| `suggest_title` | boolean | מציע גם כותרת מהתמלול, בשדה `suggestedTitle`. |

**מה חוזר:** מזהה משימה. העבירו את ה-`output_data` שלה ל-`voice_changer_pro` בפרמטר `analysis`.

## `voice_changer_pro_export`
מרנדר סרטון מוגמר מהמיקס שלכם של הרצועות: השלב האחרון במסלול האינטראקטיבי, אחרי `voice_changer_pro` עם `output: "stems"`. רצועת הווידאו מועתקת בלי קידוד מחדש.

**הרשאה:** `workflows:execute`. **ב-Nodaro Cloud בלבד.**

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `tracks` | array | **נדרש.** 1–16 רצועות, לכל אחת `url`, `gain` מ-0 עד 200 (100 הוא ללא שינוי), `muted` ו-`kind`: `voice` (ברירת המחדל) או `background`. לפחות רצועה אחת צריכה להיות לא מושתקת. |
| `video_url` או `video_asset_id` | string | סרטון המקור. |
| `voice_fx` | object | אפקט שמוחל רק על רצועות הקול. |

**מה חוזר:** מזהה משימה.

## `dubbing`
מתרגם דיבור לשפה אחרת ושומר על הקול ועל התזמון של כל דובר. כשהמקור הוא סרטון, מתקבלים הסרטון המדובב ורצועת האודיו שלו. הכלי עובד כמו רכיב [דיבוב](https://nodaro.ai/docs/nodes/audio/dubbing).

**הרשאה:** `workflows:execute`. **קרדיטים:** לפי דקה של הקטע המדובב.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `target_language` | string | **נדרש.** קוד שפה, כגון `en`, `es`, `fr`, `de`, `ja`, `zh`, `ko` או `ar`. |
| `audio_url`, `audio_asset_id`, `video_url`, `video_asset_id` או `source_url` | string | **מקור אחד בדיוק.** הפרמטר `source_url` הוא קישור ציבורי ליוטיוב, לטיקטוק או קישור ישיר, ש-Nodaro מוריד ישירות. |
| `source_language` | string | רמז לשפת המקור. כשמשמיטים אותו, השפה מזוהה אוטומטית. |
| `num_speakers` | integer | מספר הקולות השונים, עד 20. הערך `0` מזהה אותם אוטומטית. |
| `disable_voice_cloning` | boolean | משתמש בקול דומה שנשמע מקומי, במקום בקול של כל דובר. |
| `drop_background_audio` | boolean | מסיר את הרקע, למקורות של דיבור בלבד. |
| `start_time`, `end_time` | number | מדבב רק חלק מהמקור, בשניות. |
| `highest_resolution` | boolean | שומר על הרזולוציה של סרטון המקור. איטי יותר. |
| `use_profanity_filter`, `target_accent`, `watermark` | | אופציונליים. הפרמטר `target_accent` מטה את הקולות למבטא מסוים. |

דיבוב מכסה עד 30 דקות. השתמשו ב-`start_time` וב-`end_time` כדי לדבב חלק ממקור ארוך יותר.

**מה חוזר:** מזהה משימה.

## `text_to_audio`
יוצר אפקט קול מתיאור: פולי, אודיו סביבתי, צלילי ממשק. הכלי לא מיועד לדיבור או למוזיקה, והוא עובד כמו רכיב [טקסט לאודיו](https://nodaro.ai/docs/nodes/audio/text-to-audio).

**הרשאה:** `workflows:execute`. **קרדיטים:** המחיר של [ElevenLabs Sound Effects](https://nodaro.ai/docs/models/audio/elevenlabs-sound-effects), לכל שנייה של `duration`, אחרי עיגול כלפי מעלה לשנייה שלמה. קריאה בלי `duration` מתומחרת כמו 5 שניות.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `prompt` | string | הצליל, למשל "thunderstorm with heavy rain" (סופת רעמים עם גשם כבד), עד 2,000 תווים. נדרש, אלא אם ערכה מספקת אותו. |
| `duration` | number | מ-0.5 עד 30 שניות. כברירת מחדל, המודל מחליט. |
| `loop` | boolean | יוצר צליל שחוזר בלולאה רציפה, בלי קפיצה. |
| `prompt_influence` | number | עד כמה הצליל נצמד לפרומפט, מ-0 עד 1. |
| `presetId` | string | ערכה כגון **אווירת גשם**, **מעבר שוואש** או **חבטה / בום**. |

**מה חוזר:** מזהה משימה.

## `transcribe`
הופך דיבור בקובץ אודיו או וידאו לטקסט, במנוע ElevenLabs STT. תזמוני המילים, באלפיות שנייה, נמצאים תמיד ב-`output_data.json.words`. הכלי עובד כמו רכיב [תמלול](https://nodaro.ai/docs/nodes/audio/transcribe).

**הרשאה:** `workflows:execute`. **קרדיטים:** המחיר של [ElevenLabs STT](https://nodaro.ai/docs/models/audio/elevenlabs-stt).

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `audio_url` או `audio_asset_id` | string | המקור. המזהה יכול להיות של משימת אודיו או של משימת וידאו. |
| `language` | string | קוד שפה כגון `en`. כשמשמיטים אותו, השפה מזוהה אוטומטית. |
| `diarize` | boolean | מסמן כל דובר בתווית. ברירת המחדל: `false`. |
| `tag_audio_events` | boolean | מסמן צלילים כגון `[laughter]` (צחוק) או `[music]` (מוזיקה). ברירת המחדל: `false`. |
| `word_timestamps` | boolean | נשמר לתאימות. תזמוני המילים מוחזרים בכל מקרה. |

**מה חוזר:** מזהה משימה. התמלול נמצא בפלט של המשימה. כדי להוסיף לסרטון כתוביות עם טקסט מתוקן, מפו את `json.words` לפרמטר `captions` של [`add_captions`](https://nodaro.ai/docs/mcp/tools/video-editing#add_captions), פריט אחד לכל מילה. מנועי Whisper זמינים ברכיב שעל הקנבס, ב-REST API, ב-SDK וב-CLI, ולא דרך הכלי הזה.

## `audio_isolation`
מסיר מוזיקת רקע ורעשים ממיקס, ומחזיר את הקול, השירה או הכלי העיקריים כרצועה נקייה אחת. הכלי עובד כמו רכיב [מחלץ קול](https://nodaro.ai/docs/nodes/audio/voice-extractor).

**הרשאה:** `workflows:execute`. **קרדיטים:** המחיר של [ElevenLabs Voice Isolation](https://nodaro.ai/docs/models/audio/elevenlabs-voice-isolation), לפי האורך.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `audio_url` או `audio_asset_id` | string | המקור. המזהה יכול להיות של משימת אודיו או של משימת וידאו. |

**מה חוזר:** מזהה משימה.

## `separate_audio`
מפצל כל אודיו לשירה ולכלים, או לסטמים מלאים: תופים, בס, גיטרה, פסנתר ושאר הצלילים. הכלי מריץ את Demucs, ועובד גם על הקלטות שיצאו בהפצה מסחרית, ש-`suno_separate_stems` מסרב לפצל. הוא עובד כמו רכיב [הפרדת אודיו](https://nodaro.ai/docs/nodes/audio/audio-separation).

**הרשאה:** `workflows:execute`. **קרדיטים:** 33–88, לפי המצב והאיכות.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `audio_url` או `audio_asset_id` | string | המקור. הפרמטר `audio_asset_id` מקבל משימת אודיו או קובץ אודיו שהועלה, לא סרטון. |
| `mode` | string | `vocal_instrumental` (ברירת המחדל) או `stems`. |
| `quality` | string | `auto` (ברירת המחדל), `fast` או `best`. |

**מה חוזר:** מזהה משימה. קבלו את הכתובת של כל סטם, כגון `vocalUrl`, `instrumentalUrl` או `drumsUrl`, עם `get_job`.

## `apply_audio_fx`
מחיל אפקט יצירתי על קול או על קליפ: ריוורב שממקם קול יבש בחלל, או אפקט של טלפון, מגפון או הד. הכלי עובד כמו רכיב [אפקטי אודיו](https://nodaro.ai/docs/nodes/audio/audio-fx).

**הרשאה:** `workflows:execute`. **קרדיטים:** 22.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `audio_url` או `audio_asset_id` | string | המקור. המזהה יכול להיות של משימת אודיו או של משימת וידאו. |
| `preset` | string | `room` (ברירת המחדל), `bathroom`, `car`, `hall`, `concert-hall`, `church`, `cave`, `arena`, `outdoor`, `telephone`, `megaphone`, `echo` או `custom`. |
| `mix` | number | כמה ריוורב, מ-0 עד 100. |

**מה חוזר:** מזהה משימה.

## `pitch_tempo`
משנה את גובה הצליל של קול או של שיר בחצאי טונים, או את הטמפו שלו בלי לשנות את גובה הצליל. הכלי עובד כמו רכיב [גובה צליל וטמפו](https://nodaro.ai/docs/nodes/audio/pitch-tempo).

**הרשאה:** `workflows:execute`. **קרדיטים:** 22 לכל דקה של הקלט, או חלק ממנה, עד 30 דקות.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `audio_url`, `video_url` או `asset_id` | string | מקור אחד בדיוק. המזהה יכול להיות של משימת אודיו, של משימת וידאו או של העלאה. סרטון שומר על התמונה שלו. |
| `semitones` | number | מ-`-12` עד 12. ברירת המחדל היא 0. הערך 12 הוא אוקטבה אחת למעלה. |
| `tempo` | number | מ-0.5 עד 2, וגובה הצליל נשמר. ברירת המחדל היא 1. כשהמקור הוא סרטון, הפרמטר לא נלקח בחשבון. |
| `preserve_formants` | boolean | שומר על האופי הטבעי של הקול. ברירת המחדל היא `true`. כבו אותו כדי ליצור קול של סנאי או קול של ענק. |

**מה חוזר:** מזהה משימה.

## `trim_audio`
מקצץ אודיו לחלון זמן, או מחלץ את האודיו של סרטון ומקצץ אותו. הכלי עובד כמו רכיב [קיצוץ אודיו](https://nodaro.ai/docs/nodes/audio/trim-audio).

**הרשאה:** `workflows:execute`. **קרדיטים:** 11.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `audio_url`, `audio_asset_id`, `video_url` או `video_asset_id` | string | מקור אחד. כשהמקור הוא סרטון, מתקבלת רצועת האודיו שלו. |
| `start_time`, `end_time` | number | החלון, בשניות. השמיטו את שניהם כדי לשמור את כל הרצועה. |
| `audio_format` | string | `mp3` (ברירת המחדל), `wav` או `aac`. |

**מה חוזר:** מזהה משימה.

## `mix_audio`
משלב 2–20 רצועות אודיו בשכבות לקובץ אחד. עם `duck`, מוזיקת הרקע יורדת בעוצמה מתחת לקול בזמן שהקול מדבר, ועולה בחזרה בהפסקות שלו. הכלי עובד כמו רכיב [מיקס אודיו](https://nodaro.ai/docs/nodes/audio/mix-audio).

**הרשאה:** `workflows:execute`. **קרדיטים:** 22, עם הנמכה ובלעדיה.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `tracks` | array | **נדרש.** 2–20 רצועות, לפי סדר המיקס. כל רצועה היא `{ audio_url }` או `{ audio_asset_id }`, עם `volume` אופציונלי מ-0% עד 200%. ברירת המחדל: `100`. השדה `audio_asset_id` יכול להיות משימת אודיו או וידאו של Nodaro. |
| `duck` | object | מנמיך את כל שאר הרצועות מתחת לרצועת מפתח אחת. השמיטו אותו כדי לקבל מיקס רגיל. |
| `duck.under` | integer | **נדרש ב-`duck`.** המיקום של רצועת המפתח, בדרך כלל הקול, ב-`tracks`, בספירה מ-0. |
| `duck.amount` | number | בכמה שאר הרצועות יורדות, מ-0 עד 100. ברירת המחדל: `75`. |
| `duck.threshold_db` | number | הרמה ב-dBFS שרצועת המפתח צריכה לעבור כדי שההנמכה תתחיל, מ-`-60` עד 0. ברירת המחדל: `-30`. |
| `duck.ratio` | number | יחס דחיסה מ-1 עד 20. הוא גובר על `amount`. |
| `duck.attack_ms`, `duck.release_ms` | number | כמה מהר ההנמכה מתחילה, מ-1 עד 2,000 מ״ש (ברירת המחדל: `20`), וכמה לאט שאר הרצועות חוזרות, מ-10 עד 9,000 מ״ש (ברירת המחדל: `500`). |
| `end_at` | string | איפה המיקס נגמר: `longest` (ברירת המחדל), עם הרצועה הארוכה ביותר שלו, או `voice`, כשהרצועה של `duck.under` נגמרת. הערך `voice` דורש את `duck`. |

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

**מה חוזר:** מזהה משימה. המיקס הוא התוצאה של המשימה.

## `download_youtube_audio`
מחלץ את רצועת האודיו של סרטון יוטיוב.

**הרשאה:** `workflows:execute`.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `youtube_url` | string | **נדרש.** כתובת ה-URL של סרטון היוטיוב. |

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

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

### באיזה קול הכלי generate_speech משתמש כברירת מחדל?

הכלי generate_speech משתמש כברירת מחדל בקול Rachel, במודל ElevenLabs v4. העבירו ב-voice_id שם של קול מוכן מראש, כגון Aria, Roger או Charlotte, או את המזהה של קול ששכפלתם. הכלי list_voices מחזיר את הקולות המוכנים מראש.

### איך יוצרים שיחה בין שני קולות?

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

### האם ElevenLabs v4 מדבר שפות אחרות מלבד אנגלית?

כן. ElevenLabs v4 רב־לשוני לגמרי, כולל עברית, ערבית, סינית, יפנית וקוריאנית, ולכן השתמשו בו לכל שפה. הוא גם מבין תגי אודיו כגון ‎[laughs]‎ (צוחק) ו-‎[whispers]‎ (לוחש).

### איך מקבלים תזמוני מילים לכתוביות?

קראו לכלי transcribe. תזמוני המילים, באלפיות שנייה, נמצאים תמיד ב-output_data.json.words של המשימה, וזה המבנה שהכלי add_captions מקבל בפרמטר captions.

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

כן, ב-Nodaro Cloud, עם הכלי voice_changer_pro. הכלי מזהה כל דובר ונותן לו את הקול שציינתם בשבילו, לפי הסדר שבו הדוברים מדברים לראשונה, ושומר על המילים ועל התזמון.