# איך נותנים ל־Codex לתמלל אודיו ווידאו?

> מוסיפים ארבע שורות ל־~/.codex/config.toml (או מריצים codex mcp add), או שמים את ה־skill בשם kolwrite-transcribe ב־~/.agents/skills. אחרי זה Codex יכול להפוך הקלטות שבריפוזיטורי לטקסט, לכתוביות SRT או לתרגום. החיוב הוא לפי שנייה מתוך הקרדיטים שלכם ב־KolWrite.

עודכן לאחרונה: 2026-11-21 · HTML: https://console.kolwrite.com/he/agents/codex

## מה עושים פעם אחת

פותחים חשבון ויוצרים מפתח בעצמכם ב־[console.kolwrite.com](https://console.kolwrite.com/auth?lang=he): נרשמים, טוענים קרדיטים, נכנסים ל־API Keys ויוצרים מפתח. סוכן לא יכול לעשות את זה במקומכם.

שומרים את המפתח בקובץ הפרופיל של ה־shell (`~/.zshrc`,‏ `~/.bashrc`) כדי שכל סשן של סוכן יוכל לקרוא אותו, ופותחים טרמינל חדש:

```bash
export KOLWRITE_API_KEY=...   # paste the key from API Keys
```

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

## מוסיפים את שרת ה־MCP

ב־`~/.codex/config.toml`. ‏`env_vars` מעביר את `KOLWRITE_API_KEY` מה־shell שבו הפעלתם את Codex, כך שהמפתח לא נכתב לקובץ:

```toml
[mcp_servers.kolwrite]
command = "npx"
args = ["-y", "https://console.kolwrite.com/mcp/kolwrite-mcp-0.1.0.tgz"]
env_vars = ["KOLWRITE_API_KEY"]
```

או בפקודה אחת (היא שומרת את המפתח ב־config.toml):

```bash
codex mcp add kolwrite --env KOLWRITE_API_KEY="$KOLWRITE_API_KEY" -- npx -y https://console.kolwrite.com/mcp/kolwrite-mcp-0.1.0.tgz
```

השרת נותן לסוכן שישה כלים: `transcribe_file`, `transcribe_url`, `upload_file`, `get_job`, `list_models`, `list_languages`. הוא רץ על המחשב שלכם עם Node.js 18 ומעלה, והוא מורד מ־https://console.kolwrite.com/mcp/kolwrite-mcp-0.1.0.tgz (SHA-256 `0dcd6ff169b860b9363044837b8545279efa585c4987b20d81035f920f6ac7ca`).

## או מתקינים את ה־skill

Codex קורא skills מ־`~/.agents/skills` (לכל הפרויקטים) או מ־`.agents/skills` בריפוזיטורי:

```bash
mkdir -p ~/.agents/skills && cd ~/.agents/skills
curl -fsSLO https://console.kolwrite.com/skills/kolwrite-transcribe.zip && unzip -o kolwrite-transcribe.zip && rm kolwrite-transcribe.zip
```

אם skill חדש לא מופיע, מפעילים את Codex מחדש.

## משאירים את ההוראה ב־AGENTS.md

כדי שכל סשן של Codex בריפוזיטורי יכיר את ה־API גם בלי כלי, מוסיפים את השורה הזו ל־`AGENTS.md`:

```text
For speech-to-text use the KolWrite API; read https://console.kolwrite.com/agent-instructions.md before writing code. The key is in KOLWRITE_API_KEY.
```

## מה מבקשים

שלוש בקשות לדוגמה ל־Codex:

```text
תמלל את ~/Downloads/interview.m4a עם KolWrite ושמור את הטקסט בקובץ interview.txt באותה תיקייה.

הכן כתוביות SRT באנגלית ל־talk.mp4 עם KolWrite, כתובית אחת לכל משפט.

מי אמר מה ב־team-call.mp3? תמלל אותו עם זיהוי דוברים במודל oracle, ואז רשום לכל דובר את המשימות שלו.
```

## כמה זה עולה

| משימה | מודל | עלות |
| --- | --- | --- |
| ראיון של 30 דקות, טקסט רגיל | `base` | 0.24 דולר |
| פגישה של שעה עם זיהוי דוברים | `oracle` | 1.56 דולר |
| הרצאה של שעה בעברית עם כתוביות באנגלית | `oracle` | 1.44 דולר |
| שעה של אודיו רועש עם דיבור חופף | `oracle_max` | 3.60 דולר |

החיוב הוא לפי שנייה של אודיו מתוך הקרדיטים שלכם, בלי מינימום. זיהוי דוברים מוסיף 0.10 קרדיטים לשעת אודיו. שרת ה־MCP ו־kolwrite.py משתמשים ב־`base` אלא אם אתם או הסוכן קובעים מודל אחר, וב־`oracle_mini` בתרגום. כל התעריפים: [/he/models](https://console.kolwrite.com/he/models).

## מה אסור לסוכן לעשות

- לבקש מכם את המפתח בצ׳אט, להדפיס אותו או לכתוב אותו לקובץ, לפקודה או ל־commit.
- להפעיל שוב את אותו תמלול אחרי timeout או שגיאת רשת. כל הפעלה היא משימה חדשה שמחויבת בנפרד, ולכן במקום זה צריך לבדוק את המשימה הקיימת או לשאול אתכם.
- להקליד חותמות זמן בעצמו. כדי לחתוך או לצטט לפי זמן הוא לוקח מספרי מקטעים מהתמליל ומחשב את הזמנים בקוד, לפי זמני המילים.
- לשלוח כתובת של YouTube או של דף אינטרנט אחר בתור המדיה. צריך את קובץ המדיה עצמו.
- לתמלל הקלטות ארוכות (מעל שעה) בלי לומר לכם קודם מה העלות הצפויה.

## שאלות ותשובות

### האם זה עובד גם בתוסף של Codex ל־IDE?

התוסף קורא את אותו `~/.codex/config.toml`, ולכן שרת ה־MCP זמין גם שם.

### אפשר לבקש מ־Codex לכתוב קוד שקורא ל־API באפליקציה שלי?

כן. מפנים אותו אל [agent-instructions.md](https://console.kolwrite.com/agent-instructions.md) ואל [openapi.json](https://console.kolwrite.com/openapi.json). שרת ה־MCP נועד לתמלל קבצים תוך כדי עבודה, והוא לא ספרייה שמשלבים באפליקציה.

## דפים קשורים

- [Claude Code](https://console.kolwrite.com/he/agents/claude-code)
- [כל סוכן: kolwrite.py וה־skill](https://console.kolwrite.com/he/agents/any-agent)
- [כלי תמלול לסוכני AI](https://console.kolwrite.com/he/guides/transcription-tool-for-ai-agents)
- [סוכני AI ו־vibe coding](https://console.kolwrite.com/he/use-cases/ai-agents)
- [תיעוד ה־API](https://console.kolwrite.com/he/public_api_docs)

---
קבלת מפתח API: https://console.kolwrite.com/auth?lang=he · תיעוד ה־API: https://console.kolwrite.com/he/public_api_docs · llms.txt: https://console.kolwrite.com/llms.txt
