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

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

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

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 או לכללי הפרויקט של הכלי, כך שכל סשן עתידי ישתמש באותו מקור:

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: טקסט, זמני התחלה וסיום ותוויות דוברים.

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

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, קונה יחידות שימוש ויוצר מפתח בדף מפתחות ה־API. סוכן לא יכול להירשם בעצמו. שמרו את המפתח במשתנה סביבה (KOLWRITE_API_KEY) או במאגר הסודות של הפלטפורמה, וקראו ל־API רק מקוד צד־שרת או מפונקציית serverless, אף פעם לא מהדפדפן.

כמה זה עולה

חיוב לפי שנייה, בלי מינימום. המחירון המלא: /llms/pricing.md.

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

• llms.txt: איזו קריאה ואיזה מודל לכל משימה.
• llms-full.txt: כל התיעוד בקובץ Markdown אחד.
• openapi.json: ‏OpenAPI 3.1 למחוללי קוד ולהגדרות כלים.
• agent-instructions.md: הפרומפט, מזהי המודלים והמלכודות.
• לכל דף באתר יש גם גרסת Markdown: מוסיפים .md לכתובת.

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