# كيف أجعل Codex يفرّغ الصوت والفيديو؟

> أضف أربعة أسطر إلى ~/.codex/config.toml (أو شغّل codex mcp add)، أو ضع المهارة kolwrite-transcribe في ~/.agents/skills. بعدها يستطيع Codex تحويل التسجيلات الموجودة في مستودعك إلى نص أو ترجمات SRT أو ترجمة إلى لغة أخرى، وتُحتسب التكلفة بالثانية من رصيدك في KolWrite.

آخر تحديث: 2026-11-21 · HTML: https://console.kolwrite.com/ar/agents/codex

## ما تفعله مرة واحدة

أنشئ الحساب والمفتاح بنفسك من [console.kolwrite.com](https://console.kolwrite.com/auth?lang=ar): سجّل، وأضف رصيدًا، ثم افتح «API Keys» وأنشئ مفتاحًا. لا يستطيع الوكيل القيام بذلك نيابةً عنك.

احفظ المفتاح في ملف إعدادات الـ shell (`~/.zshrc` أو `~/.bashrc`) لتتمكن كل جلسة وكيل تبدأها من قراءته، ثم افتح نافذة طرفية جديدة:

```bash
export KOLWRITE_API_KEY=...   # paste the key from API Keys
```

تقرأ الأدوات المفتاح من هذا المتغير فقط. لا تلصقه في محادثة ولا تضعه في مستودع.

## إضافة خادم MCP

في `~/.codex/config.toml`. يمرّر `env_vars` المتغير `KOLWRITE_API_KEY` من الـ shell الذي شغّلت منه Codex، فلا يُكتب المفتاح في الملف:

```toml
[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):

```bash
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`).

## أو تثبيت مهارة الوكيل

يقرأ Codex المهارات من `~/.agents/skills` (لكل المشاريع) أو من `.agents/skills` داخل المستودع:

```bash
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
```

إذا لم تظهر المهارة الجديدة، أعد تشغيل Codex.

## إبقاء القاعدة في AGENTS.md

لكي تتعرّف كل جلسة Codex في المستودع على الـ API حتى دون أداة، أضف هذا السطر إلى `AGENTS.md`:

```text
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:

```text
فرّغ الملف ~/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` عند الترجمة. الأسعار كاملةً: [/ar/models](https://console.kolwrite.com/ar/models).

## ما يجب ألا يفعله الوكيل

- أن يطلب منك المفتاح في المحادثة، أو يطبعه، أو يكتبه في ملف أو أمر أو commit.
- أن يعيد بدء التفريغ نفسه بعد انتهاء المهلة أو حدوث خطأ في الشبكة. كل بدء يُنشئ مهمة جديدة تُحتسب تكلفتها، لذا عليه أن يتحقق من حالة المهمة القائمة أو يسألك.
- أن يكتب الطوابع الزمنية بنفسه. لقصّ مقطع أو اقتباسه بحسب الوقت، يأخذ أرقام المقاطع من التفريغ ويحسب الأوقات في الكود من أوقات الكلمات.
- أن يرسل رابط YouTube أو أي صفحة ويب أخرى على أنه الملف. المطلوب هو ملف الوسائط نفسه.
- أن يفرّغ تسجيلات طويلة (أكثر من ساعة) دون أن يخبرك بالتكلفة المتوقعة أولًا.

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

### هل يعمل هذا في إضافة Codex لبيئات التطوير (IDE) أيضًا؟

تقرأ الإضافة الملف نفسه `~/.codex/config.toml`، لذا يتوفر خادم MCP فيها كذلك.

### هل يستطيع Codex كتابة كود يستدعي الـ API داخل تطبيقي؟

نعم. وجّهه إلى [agent-instructions.md](https://console.kolwrite.com/agent-instructions.md) و[openapi.json](https://console.kolwrite.com/openapi.json). خادم MCP مخصص لتفريغ الملفات أثناء عملك، وليس مكتبة تدمجها في تطبيقك.

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

- [Claude Code](https://console.kolwrite.com/ar/agents/claude-code)
- [أي وكيل: kolwrite.py والمهارة](https://console.kolwrite.com/ar/agents/any-agent)
- [أداة تفريغ لوكلاء الذكاء الاصطناعي](https://console.kolwrite.com/ar/guides/transcription-tool-for-ai-agents)
- [وكلاء الذكاء الاصطناعي والبرمجة بالإيحاء](https://console.kolwrite.com/ar/use-cases/ai-agents)
- [توثيق الـ API](https://console.kolwrite.com/ar/public_api_docs)

---
احصل على مفتاح 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
