איך נותנים ל־Codex לתמלל אודיו ווידאו?
מוסיפים ארבע שורות ל־~/.codex/config.toml (או מריצים codex mcp add), או שמים את ה־skill בשם kolwrite-transcribe ב־~/.agents/skills. אחרי זה Codex יכול להפוך הקלטות שבריפוזיטורי לטקסט, לכתוביות SRT או לתרגום. החיוב הוא לפי שנייה מתוך הקרדיטים שלכם ב־KolWrite.
מה עושים פעם אחת
פותחים חשבון ויוצרים מפתח בעצמכם ב־console.kolwrite.com: נרשמים, טוענים קרדיטים, נכנסים ל־API Keys ויוצרים מפתח. סוכן לא יכול לעשות את זה במקומכם.
שומרים את המפתח בקובץ הפרופיל של ה־shell (~/.zshrc, ~/.bashrc) כדי שכל סשן של סוכן יוכל לקרוא אותו, ופותחים טרמינל חדש:
export KOLWRITE_API_KEY=... # paste the key from API Keys
הכלים קוראים את המפתח רק מהמשתנה הזה. אל תדביקו אותו בצ׳אט ואל תעלו אותו לריפוזיטורי.
מוסיפים את שרת ה־MCP
ב־~/.codex/config.toml. env_vars מעביר את KOLWRITE_API_KEY מה־shell שבו הפעלתם את Codex, כך שהמפתח לא נכתב לקובץ:
[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):
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 בריפוזיטורי:
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:
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:
תמלל את ~/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.
מה אסור לסוכן לעשות
- לבקש מכם את המפתח בצ׳אט, להדפיס אותו או לכתוב אותו לקובץ, לפקודה או ל־commit.
- להפעיל שוב את אותו תמלול אחרי timeout או שגיאת רשת. כל הפעלה היא משימה חדשה שמחויבת בנפרד, ולכן במקום זה צריך לבדוק את המשימה הקיימת או לשאול אתכם.
- להקליד חותמות זמן בעצמו. כדי לחתוך או לצטט לפי זמן הוא לוקח מספרי מקטעים מהתמליל ומחשב את הזמנים בקוד, לפי זמני המילים.
- לשלוח כתובת של YouTube או של דף אינטרנט אחר בתור המדיה. צריך את קובץ המדיה עצמו.
- לתמלל הקלטות ארוכות (מעל שעה) בלי לומר לכם קודם מה העלות הצפויה.
שאלות ותשובות
האם זה עובד גם בתוסף של Codex ל־IDE?
התוסף קורא את אותו ~/.codex/config.toml, ולכן שרת ה־MCP זמין גם שם.
אפשר לבקש מ־Codex לכתוב קוד שקורא ל־API באפליקציה שלי?
כן. מפנים אותו אל agent-instructions.md ואל openapi.json. שרת ה־MCP נועד לתמלל קבצים תוך כדי עבודה, והוא לא ספרייה שמשלבים באפליקציה.