كيف أنشئ GPT مخصّصًا يفرّغ الصوت؟
أنشئ GPT مخصّصًا، واستورد https://console.kolwrite.com/openapi.json كـ Action، واضبط مفتاحك في الترويسة x-api-key، ثم الصق التعليمات أدناه. بعدها يستطيع الـ GPT تفريغ ملفات الوسائط الموجودة على الإنترنت وإنشاء ترجمات نصية لها وترجمتها من رصيدك في KolWrite. يرسل الـ Action بيانات JSON فقط، لذا يعمل مع روابط ملفات الوسائط ولا يعمل مع الملفات التي ترفقها في المحادثة.
ما تفعله مرة واحدة
أنشئ الحساب والمفتاح بنفسك من console.kolwrite.com: سجّل، وأضف رصيدًا، ثم افتح «API Keys» وأنشئ مفتاحًا. لا يستطيع الوكيل القيام بذلك نيابةً عنك.
ستلصق المفتاح في محرّر الـ GPT، لا في محادثة.
إنشاء الـ GPT والـ Action
- في ChatGPT افتح Explore GPTs، ثم Create، ثم تبويب Configure. يتطلب إنشاء GPT اشتراكًا مدفوعًا في ChatGPT.
- ضمن Actions اختر Create new action، ثم Import from URL، وأدخل
https://console.kolwrite.com/openapi.json. - Authentication: API Key، وAuth Type بقيمة Custom، وCustom Header Name بقيمة
x-api-key، ثم الصق مفتاح KolWrite. - Privacy policy:
https://www.kolwrite.com/tos_pp.html. - الصق التعليمات أدناه في حقل Instructions.
- Share: Only me. كل من يستطيع استخدام الـ GPT يصرف من رصيدك.
التعليمات التي تُلصق
You transcribe audio and video with the KolWrite API actions.
- The person gives a direct link to a media file (mp3, m4a, wav, mp4, mov...). A YouTube or other web page link is not a media file: say so and ask for the file's own link.
- Start with createTranscription. Always send model: "oracle" unless the person asks for cheaper ("base") or hardest audio ("oracle_max"). For subtitles send output_format "srt" and word_timestamps false. For "who said what" send include_diarization true. To translate, send translate_to with the language code.
- After you start a job, tell the person the jobId and call getTranscription. If status is PENDING or IN_PROGRESS, say it is still running and check again when the person asks.
- When status is COMPLETED, show the result (for srt, in a code block) and the creditsUsed value. When FAILED, show the error text as it is.
- Never start the same job twice: each start is billed. If an action call fails, show the error; do not retry createTranscription.
- Tell the person the expected cost before transcribing more than an hour: base US$0.48, oracle US$1.44, oracle_max US$3.60 per hour of audio.
ماذا تطلب
ثلاثة طلبات يمكنك تجربتها مع الـ GPT (بروابطك أنت):
فرّغ https://example.com/episode-12.mp3
أنشئ ترجمات SRT بالإنجليزية للملف https://example.com/talk-he.mp4
من يتحدث في https://example.com/call.wav، وعلى ماذا اتفق كل واحد منهم؟
ما يعمل وما لا يعمل
- ما يعمل: روابط ملفات الوسائط التي يمكن الوصول إليها من الإنترنت، وأي لغة من اللغات الـ 100، والترجمات النصية، وتمييز المتحدثين، والترجمة إلى لغة أخرى.
- ما لا يعمل: الملفات التي ترفعها في المحادثة، إذ لا يستطيع الـ Action تمريرها إلى KolWrite. استخدم رابطًا، أو استخدم مع الملفات المحلية Claude Code أو Codex أو kolwrite.py.
- تستغرق التسجيلات الطويلة بضع دقائق. لا يستطيع الـ GPT الانتظار في الخلفية، فاطلب منه التحقق من المهمة مرة أخرى.
- قد لا يتسع ردّ الـ GPT لنتائج JSON الكبيرة جدًا، فاطلب txt أو srt بدلًا منها.
التكلفة
| المهمة | النموذج | التكلفة |
|---|---|---|
| مقابلة مدتها 30 دقيقة، نص عادي | base | 0.24 دولار |
| اجتماع مدته ساعة مع تمييز المتحدثين | oracle | 1.56 دولار |
| محاضرة بالعبرية مدتها ساعة مع ترجمات نصية بالإنجليزية | oracle | 1.44 دولار |
| ساعة من صوت مشوَّش وكلام متداخل | oracle_max | 3.60 دولار |
تُحتسب التكلفة بالثانية من مدة الصوت وتُخصم من رصيدك، دون حدّ أدنى. يضيف تمييز المتحدثين 0.10 رصيد لكل ساعة صوت. الأسعار كاملةً: /ar/models.
ما يجب ألا يفعله الـ GPT
- أن يعيد بدء التفريغ نفسه بعد انتهاء المهلة أو حدوث خطأ في الشبكة. كل بدء يُنشئ مهمة جديدة تُحتسب تكلفتها، لذا عليه أن يتحقق من حالة المهمة القائمة أو يسألك.
- أن يرسل رابط YouTube أو أي صفحة ويب أخرى على أنه الملف. المطلوب هو ملف الوسائط نفسه.
- أن يفرّغ تسجيلات طويلة (أكثر من ساعة) دون أن يخبرك بالتكلفة المتوقعة أولًا.
- أن يُشارَك مع غيرك ما دام يحمل مفتاحك.
أسئلة وأجوبة
هل هذا هو موصّل KolWrite الخاص بـ ChatGPT؟
لا. هذا GPT تنشئه أنت بمفتاح الـ API ورصيدك. أما الموصّل الخاص بحساب KolWrite الشخصي فهو موصوف في agent-instructions.md.
هل يمكنني استخدام ملف openapi.json نفسه في أدوات أخرى؟
نعم. هو بصيغة OpenAPI 3.1 مع أمثلة وردود الأخطاء الفعلية، ويمكن لأي أداة تستورد OpenAPI وترسل الترويسة x-api-key أن تستخدمه.