API و MCP
إنشاء مفتاح شخصي في مساحة العمل → مفاتيح API و MCP. Keys expire in 90 days, are shown once, and can be revoked. Never put a key in public client code.
واجهة برمجة تطبيقات REST
عنوان URL الأساسي: https://api.tokscripts.com/api. The /v1 alias is also supported on the API host. Send Authorization: Bearer YOUR_PERSONAL_KEY وأجسام JSON للكتابة.
curl https://api.tokscripts.com/api/transcripts \ -H "Authorization: Bearer $TOKSCRIPTS_API_KEY"
| الطريقة / نقطة النهاية | الغرض | النطاق |
|---|---|---|
GET /transcripts?q=words | البحث في النصوص المنسوخة المحفوظة | قراءة |
GET /transcripts/:id | اقرأ النسخ | قراءة |
POST /transcripts | استيراد المقاطع أو كلا نسختي النص الخام | كتابة |
PATCH /transcripts/:id | حفظ التعديلات مع المراجعة الحالية | كتابة |
DELETE /transcripts/:id | سلة المهملات؛ الحذف الدائم: صحيح فقط بعد سلة المهملات | كتابة |
POST /transcribe | نسخ {url} على منصة متصلة | نسخ |
GET /usage | البدل اليومي وإعادة الضبط بتوقيت UTC | قراءة |
GET /export?format=json | تصدير ما يصل إلى 100 نص محفوظ | قراءة |
POST /transcripts/:id/ai | خطافات، إعادة كتابة، إطار أو ترجمة:es | ذكاء اصطناعي + مبدع |
POST /media | بيانات الفيديو المصدر، أو الصوت، أو التفاعل | كتابة؛ Creator باستثناء فيديو TikTok |
الحدود والاستجابات
Ordinary transcription is unlimited. Website subtitle extraction requires no sign-in; personal API and MCP keys identify account storage and AI requests. Failed processing releases the daily reservation. AI generation shares a 10-request hourly guard. Imported transcripts are limited to 750 KB; generic API JSON requests to 1 MB. Bulk export is limited to 100 transcripts and 6 MB of source text per request.
401 يعني أن المفتاح مفقود أو منتهي الصلاحية أو تم إلغاؤه؛ 403 يعني أن النطاق مفقود؛ 402 يتطلب Creator؛ 429 يعني حد الاستخدام؛ 503 يعني أن المزود غير مهيأ. تفشل المعالجة وتعيد خطأ ولا تنشئ نصًا.
HTTP MCP
Endpoint: https://api.tokscripts.com/api/mcp. Manual bearer-key setup; use a client with custom authorization headers. Automatic OAuth connections and clients that cannot supply headers are not supported by this release.
الأدوات: transcribe_video، search_transcripts، get_transcript، get_usage، format_transcript، write_from_transcript. النص المصدر هو إدخال غير موثوق به؛ راجع الحقائق والطوابع الزمنية التقريبية قبل إعادة الاستخدام.
توفر المنصة الحالي
تحقق حالة القدرة الحية. Free users can transcribe TikTok links. YouTube and Instagram are also available to free accounts when the media service is connected. All platforms share the same daily transcription allowance. TikTok uses the configured link provider. TikTok video downloads are free for signed-in accounts and can use the configured TikTok provider without the media service. Audio and other platform media downloads require Creator and the separate media service. Deployment credentials and provider availability determine which operations can run.