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

> الصق موجّهًا واحدًا في وكيل البرمجة ليضيف التفريغ الصوتي إلى تطبيقك: KolWrite API عبارة عن استدعاءين HTTP، ومفتاح في متغير بيئة، وفوترة بالثانية تبدأ من 0.48 دولار لكل ساعة صوت.

آخر تحديث: 2026-10-08 · HTML: https://console.kolwrite.com/ar/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=ar)، ويشتري وحدات الاستخدام، وينشئ مفتاحًا في صفحة مفاتيح API. لا يستطيع الوكيل التسجيل بنفسه. ضع المفتاح في متغير بيئة (`KOLWRITE_API_KEY`) أو في مخزن الأسرار لدى منصتك، واستدعِ الواجهة من كود الخادم أو دالة 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` إلى عنوانها.

## أسئلة وأجوبة

### هل يستطيع وكيل الذكاء الاصطناعي إنشاء حساب أو مفتاح API؟

لا. يسجّل شخصٌ وينشئ المفتاح، ويقرأه الوكيل من متغير بيئة.

### أي نموذج يختاره الوكيل افتراضيًا؟

`oracle` لصوت الإنتاج، و`base` لأقل تكلفة مع الصوت الواضح، و`oracle_mini` عندما تحتاج الترجمة بتكلفة منخفضة. أرسل `model` دائمًا، فالقيمة الافتراضية هي النموذج القديم `core`.

### هل أستطيع استدعاء الواجهة من تطبيق واجهة أمامية فقط بُني في Lovable أو Bolt أو v0؟

ليس والمفتاح في المتصفح. استخدم دوال الخادم أو الحافة في المنصة لاستدعاء KolWrite وإبقاء المفتاح سرًا.

## صفحات ذات صلة

- [المطورون وفرق المنتجات](https://console.kolwrite.com/ar/use-cases/developers)
- [الإعلام والبودكاست والترجمة المرئية](https://console.kolwrite.com/ar/use-cases/media)
- [مراكز الاتصال ومكالمات المبيعات](https://console.kolwrite.com/ar/use-cases/call-centers)
- [اللغات المدعومة](https://console.kolwrite.com/ar/languages/)

---
احصل على مفتاح API: https://console.kolwrite.com/auth?lang=ar · توثيق الـ API: https://console.kolwrite.com/ar/public_api_docs · llms.txt: https://console.kolwrite.com/llms.txt