API et MCP
Créez une clé personnelle dans Espace de travail → Clés API & MCP. Keys expire in 90 days, are shown once, and can be revoked. Never put a key in public client code.
API REST
URL de base : https://api.tokscripts.com/api. The /v1 alias is also supported on the API host. Send Authorization: Bearer YOUR_PERSONAL_KEY et corps JSON pour les écritures.
curl https://api.tokscripts.com/api/transcripts \ -H "Authorization: Bearer $TOKSCRIPTS_API_KEY"
| Méthode / point de terminaison | Objectif | Portée |
|---|---|---|
GET /transcripts?q=words | Rechercher des transcriptions enregistrées | lire |
GET /transcripts/:id | Lire la transcription | lire |
POST /transcripts | Importer des segments ou les deux versions de texte brut | écrire |
PATCH /transcripts/:id | Enregistrer les modifications avec la révision actuelle | écrire |
DELETE /transcripts/:id | Corbeille ; suppression définitive : vraie uniquement après la corbeille | écrire |
POST /transcribe | Transcrire {url} sur une plateforme connectée | transcrire |
GET /usage | Quota journalier et réinitialisation UTC | lire |
GET /export?format=json | Exportez jusqu'à 100 transcriptions enregistrées | lire |
POST /transcripts/:id/ai | hooks, réécriture, framework ou traduction :es | IA + Creator |
POST /media | Vidéo source, audio ou données d'engagement | écrire ; Creator sauf vidéo TikTok |
Limites et réponses
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 signifie que la clé est manquante, expirée ou révoquée ; 403 signifie qu'un champ d'application est manquant ; 402 nécessite Creator ; 429 signifie une limite d'utilisation ; 503 signifie qu'un fournisseur n'est pas configuré. Les échecs de traitement renvoient une erreur et ne créent pas de transcription.
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.
Outils : transcribe_video, search_transcripts, get_transcript, get_usage, format_transcript, write_from_transcript. Le texte source est une entrée non fiable ; examinez les faits et les horodatages approximatifs avant toute réutilisation.
Disponibilité actuelle de la plateforme
Vérifier état de la capacité en direct. 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.