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 API
آدرس پایه: 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 | سطل زباله؛ دائمی:true فقط پس از سطل زباله | نوشتن |
POST /transcribe | رونویسی {url} در یک پلتفرم متصل | رونویسی |
GET /usage | سهمیه روزانه و بازنشانی UTC | خواندن |
GET /export?format=json | تا ۱۰۰ رونوشت ذخیره شده را خروجی بگیرید | خواندن |
POST /transcripts/:id/ai | قلاب‌ها، بازنویسی، چارچوب یا ترجمه:ها | هوش مصنوعی + Creator |
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 به معنی دامنه (scope) گم شده است؛ 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.