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
基础 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 | 移至回收站；仅在回收站内可 permanent:true | 写入 |
POST /transcribe | 在已连接平台转录 {url} | 转录 |
GET /usage | 每日额度与 UTC 重置 | 读取 |
GET /export?format=json | 最多导出 100 份已保存转录稿 | 读取 |
POST /transcripts/:id/ai | hooks、rewrite、framework 或 translate:es | ai + Creator |
POST /media | 原视频、音频或互动数据 | write + Creator |
限制与响应
每个账户每个 UTC 日有五次新转录任务，网站、API 和 MCP 共享。处理失败会释放预留额度。AI 生成共享每小时 10 次请求限制。导入转录稿最大 750 KB，普通 API JSON 请求最大 1 MB。每次批量导出最多 100 份转录稿、6 MB 来源文字。
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. Instagram, YouTube, profile expansion and source media downloads require the separate media service. Deployment credentials and provider availability determine which operations can run.