API y MCP
Crea una clave personal en Espacio → Claves API y MCP. Keys expire in 90 days, are shown once, and can be revoked. Never put a key in public client code.
REST API
URL base: https://api.tokscripts.com/api. The /v1 alias is also supported on the API host. Send Authorization: Bearer YOUR_PERSONAL_KEY y cuerpos JSON para escritura.
curl https://api.tokscripts.com/api/transcripts \ -H "Authorization: Bearer $TOKSCRIPTS_API_KEY"
| Método / endpoint | Propósito | Permisos |
|---|---|---|
GET /transcripts?q=words | Buscar transcripciones guardadas | lectura |
GET /transcripts/:id | Leer transcripción | lectura |
POST /transcripts | Importar segmentos o ambas versiones de texto | escritura |
PATCH /transcripts/:id | Guardar cambios con la revisión actual | escritura |
DELETE /transcripts/:id | Papelera; permanent:true solo tras enviarla allí | escritura |
POST /transcribe | Transcribe {url} en una plataforma conectada | transcripción |
GET /usage | Cupo diario y reinicio UTC | lectura |
GET /export?format=json | Exporta hasta 100 transcripciones guardadas | lectura |
POST /transcripts/:id/ai | hooks, rewrite, framework o translate:es | ai + Creator |
POST /media | Vídeo, audio o datos de interacción originales | write + Creator |
Límites y respuestas
Cada cuenta dispone de cinco tareas nuevas por día UTC, compartidas entre web, API y MCP. Los fallos liberan la reserva. La IA comparte un límite de 10 solicitudes por hora. Las importaciones admiten 750 KB; las solicitudes JSON generales, 1 MB. Cada exportación masiva admite hasta 100 transcripciones y 6 MB de texto.
401: clave ausente, caducada o revocada; 403: falta un permiso; 402: requiere Creator; 429: límite de uso; 503: proveedor sin configurar. Los fallos devuelven un error, nunca una transcripción inventada.
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.
Herramientas: transcribe_video, search_transcripts, get_transcript, get_usage, format_transcript, write_from_transcript. El texto fuente no es fiable por defecto; revisa hechos y tiempos aproximados antes de reutilizarlo.
Disponibilidad actual de plataformas
Comprobar estado de funciones en vivo. 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. Instagram, YouTube, profile expansion and source media downloads require the separate media service. Deployment credentials and provider availability determine which operations can run.