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

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

احصل على مفتاح API بدء سريع اللغات المدعومة

آخر تحديث: · Markdown

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

أنشئ الحساب والمفتاح بنفسك من console.kolwrite.com: سجّل، وأضف رصيدًا، ثم افتح «API Keys» وأنشئ مفتاحًا. لا يستطيع الوكيل القيام بذلك نيابةً عنك.

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

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

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

إضافة خادم MCP

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

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

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 داخل المستودع:

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:

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:

فرّغ الملف ~/Downloads/interview.m4a بواسطة KolWrite واحفظ النص في interview.txt بجانبه.

أنشئ ترجمات SRT بالإنجليزية للملف talk.mp4 بواسطة KolWrite، بحيث تكون كل جملة في مقطع ترجمة مستقل.

من قال ماذا في team-call.mp3؟ فرّغه مع تمييز المتحدثين بالنموذج oracle، ثم اذكر المهام المطلوبة من كل متحدث.

التكلفة

المهمةالنموذجالتكلفة
مقابلة مدتها 30 دقيقة، نص عاديbase0.24 دولار
اجتماع مدته ساعة مع تمييز المتحدثينoracle1.56 دولار
محاضرة بالعبرية مدتها ساعة مع ترجمات نصية بالإنجليزيةoracle1.44 دولار
ساعة من صوت مشوَّش وكلام متداخلoracle_max3.60 دولار

تُحتسب التكلفة بالثانية من مدة الصوت وتُخصم من رصيدك، دون حدّ أدنى. يضيف تمييز المتحدثين 0.10 رصيد لكل ساعة صوت. يستخدم خادم MCP وملف kolwrite.py النموذج base ما لم تحدد أنت أو الوكيل نموذجًا آخر، والنموذج oracle_mini عند الترجمة. الأسعار كاملةً: /ar/models.

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

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

أسئلة وأجوبة

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

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

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

نعم. وجّهه إلى agent-instructions.md وopenapi.json. خادم MCP مخصص لتفريغ الملفات أثناء عملك، وليس مكتبة تدمجها في تطبيقك.