# תמלול דיבור לסוכני AI ולמפתחי vibe coding

> מדביקים פרומפט אחד בסוכן הקוד, והוא מוסיף תמלול לאפליקציה: KolWrite API הוא שתי קריאות HTTP, מפתח במשתנה סביבה וחיוב לפי שנייה, מ־0.48 דולר לשעת אודיו.

עודכן לאחרונה: 2026-10-08 · HTML: https://console.kolwrite.com/he/use-cases/ai-agents

## הפרומפט להדבקה

עובד ב־Cursor,‏ Claude Code,‏ Codex,‏ Windsurf,‏ Lovable,‏ Replit,‏ Bolt ו־v0. הוא מפנה את הסוכן להוראות הקריאות־למכונה, כדי שישתמש במזהי המודלים ובפרמטרים הנכונים.

```text
Add speech-to-text to this app with the KolWrite API.
Read https://console.kolwrite.com/agent-instructions.md first.
- Key: process.env.KOLWRITE_API_KEY, sent as the x-api-key header (server side only).
- POST https://app.kolwrite.com/transcribe {"audio_url", "model": "oracle", "language": "auto", "output_format": "json"}
- Local files: POST /upload first, then use fileUrl as audio_url.
- Poll GET /transcribe/{jobId} every 5 s until COMPLETED or FAILED.
- Show result.segments (start, end, speaker, text).
```

## נעיצה בפרויקט

הוסיפו את השורה הזו ל־`AGENTS.md`,‏ `CLAUDE.md`,‏ `.cursorrules` או לכללי הפרויקט של הכלי, כך שכל סשן עתידי ישתמש באותו מקור:

```text
For speech-to-text use the KolWrite API; read https://console.kolwrite.com/agent-instructions.md and https://console.kolwrite.com/llms-full.txt before writing code.
```

## מה הסוכן יבנה

1. לוקח את כתובת הקובץ (או מעלה קובץ מקומי עם `POST /upload` ומשתמש ב־`fileUrl`).
2. פותח משימה עם `POST /transcribe` ושומר את ה־`jobId`.
3. בודק את `GET /transcribe/{jobId}` עד `COMPLETED`, או מקבל webhook.
4. מציג את `result.segments`: טקסט, זמני התחלה וסיום ותוויות דוברים.

הבקשה הקטנה ביותר שעובדת (הודעה קולית לטקסט פשוט):

```bash
curl https://app.kolwrite.com/transcribe \
  -H "x-api-key: $KOLWRITE_API_KEY" -H "Content-Type: application/json" \
  -d '{"audio_url": "https://example.com/voice-note.m4a", "model": "oracle_mini", "output_format": "txt"}'
```

## מאיפה מגיע מפתח ה־API

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

## כמה זה עולה

| משימה | מודל | עלות |
| --- | --- | --- |
| 10 הודעות קוליות של דקה | `oracle_mini` | 0.16 דולר |
| פגישה של שעה עם זיהוי דוברים | `oracle` | 1.44 דולר |
| 100 שעות של אודיו נקי | `base` | 48.00 דולר |

חיוב לפי שנייה, בלי מינימום. המחירון המלא: [/llms/pricing.md](https://console.kolwrite.com/llms/pricing.md).

## מקורות קריאים למכונה

- [llms.txt](https://console.kolwrite.com/llms.txt): איזו קריאה ואיזה מודל לכל משימה.
- [llms-full.txt](https://console.kolwrite.com/llms-full.txt): כל התיעוד בקובץ Markdown אחד.
- [openapi.json](https://console.kolwrite.com/openapi.json): ‏OpenAPI 3.1 למחוללי קוד ולהגדרות כלים.
- [agent-instructions.md](https://console.kolwrite.com/agent-instructions.md): הפרומפט, מזהי המודלים והמלכודות.
- לכל דף באתר יש גם גרסת Markdown: מוסיפים `.md` לכתובת.

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

### האם סוכן AI יכול לפתוח חשבון או ליצור מפתח API?

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

### באיזה מודל סוכן צריך לבחור כברירת מחדל?

`oracle` לאודיו של מוצר אמיתי, `base` לעלות הנמוכה ביותר באודיו נקי, `oracle_mini` כשצריך גם תרגום בזול. תמיד שלחו `model`, כי ברירת המחדל היא המודל הוותיק `core`.

### אפשר לקרוא ל־API מאפליקציית front-end שנבנתה ב־Lovable,‏ Bolt או v0?

לא עם המפתח בדפדפן. השתמשו בפונקציות השרת או ה־edge של הפלטפורמה כדי לקרוא ל־KolWrite ולשמור על המפתח בסוד.

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

- [מפתחים וצוותי מוצר](https://console.kolwrite.com/he/use-cases/developers)
- [מדיה, פודקאסטים וכתוביות](https://console.kolwrite.com/he/use-cases/media)
- [מוקדי שירות ושיחות מכירה](https://console.kolwrite.com/he/use-cases/call-centers)
- [שפות נתמכות](https://console.kolwrite.com/he/languages/)

---
קבלת מפתח 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