API e MCP
Crie uma chave pessoal em Espaço → Chaves API e 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 e corpos JSON para gravação.
curl https://api.tokscripts.com/api/transcripts \ -H "Authorization: Bearer $TOKSCRIPTS_API_KEY"
| Método / endpoint | Propósito | Permissões |
|---|---|---|
GET /transcripts?q=words | Buscar transcrições salvas | leitura |
GET /transcripts/:id | Ler transcrição | leitura |
POST /transcripts | Importar segmentos ou ambas as versões de texto | escrita |
PATCH /transcripts/:id | Salvar alterações com a revisão atual | escrita |
DELETE /transcripts/:id | Lixeira; permanent:true somente após enviar para lá | escrita |
POST /transcribe | Transcreva {url} em uma plataforma conectada | transcrição |
GET /usage | Cota diária e renovação UTC | leitura |
GET /export?format=json | Exporte até 100 transcrições salvas | leitura |
POST /transcripts/:id/ai | hooks, rewrite, framework ou translate:es | ai + Creator |
POST /media | Vídeo, áudio ou dados de engajamento originais | write + Creator |
Limites e respostas
Cada conta tem cinco tarefas novas por dia UTC, compartilhadas entre site, API e MCP. Falhas liberam a reserva. A IA compartilha um limite de 10 solicitações por hora. Importações aceitam 750 KB; solicitações JSON gerais, 1 MB. Cada exportação em lote aceita até 100 transcrições e 6 MB de texto.
401: chave ausente, expirada ou revogada; 403: falta de permissão; 402: exige Creator; 429: limite de uso; 503: provedor não configurado. Falhas retornam um erro, nunca uma transcrição 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.
Ferramentas: transcribe_video, search_transcripts, get_transcript, get_usage, format_transcript, write_from_transcript. O texto-fonte não é confiável por padrão; confira fatos e tempos aproximados antes de reutilizar.
Disponibilidade atual das plataformas
Verificar estado das funções ao 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.