تحويل الكلام إلى نص لوكلاء الذكاء الاصطناعي ومطوري البرمجة بالإيحاء

الموجّه الجاهز للصق

يعمل في 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) أو في مخزن الأسرار لدى منصتك، واستدعِ الواجهة من كود الخادم أو دالة serverless فقط، وليس من المتصفح أبدًا.

كم يكلّف

الفوترة بالثانية بلا حد أدنى. جدول الأسعار الكامل: /llms/pricing.md.

مراجع مقروءة آليًا

• llms.txt: أي استدعاء وأي نموذج لكل مهمة.
• llms-full.txt: المرجع الكامل في ملف Markdown واحد.
• openapi.json: مواصفة OpenAPI 3.1 لمولّدات الكود وتعريفات الأدوات.
• agent-instructions.md: الموجّه ومعرّفات النماذج والأخطاء الشائعة.
• لكل صفحة في الموقع نسخة Markdown أيضًا: أضف .md إلى عنوانها.

أسئلة وأجوبة