API und MCP
Erstelle einen persönlichen Schlüssel unter Arbeitsbereich → API-Schlüssel und MCP. Keys expire in 90 days, are shown once, and can be revoked. Never put a key in public client code.
REST-API
Basis-URL: https://api.tokscripts.com/api. The /v1 alias is also supported on the API host. Send Authorization: Bearer YOUR_PERSONAL_KEY und JSON-Inhalte für Schreibzugriffe.
curl https://api.tokscripts.com/api/transcripts \ -H "Authorization: Bearer $TOKSCRIPTS_API_KEY"
| Methode / Endpunkt | Zweck | Berechtigung |
|---|---|---|
GET /transcripts?q=words | Gespeicherte Transkripte durchsuchen | read |
GET /transcripts/:id | Transkript lesen | read |
POST /transcripts | Abschnitte oder beide Rohtextversionen importieren | write |
PATCH /transcripts/:id | Änderungen mit aktueller Revision speichern | write |
DELETE /transcripts/:id | Papierkorb; permanent:true erst nach Verschieben | write |
POST /transcribe | {url} auf einer verbundenen Plattform transkribieren | transcribe |
GET /usage | Tageskontingent und UTC-Neustart | read |
GET /export?format=json | Bis zu 100 gespeicherte Transkripte exportieren | read |
POST /transcripts/:id/ai | hooks, rewrite, framework oder translate:es | ai + Creator |
POST /media | Quellvideo, Audio oder Interaktionsdaten | write; Creator außer TikTok-Video |
Limits und Antworten
Fünf neue Transkriptionsaufträge pro Konto und UTC-Tag, gemeinsam für Website, API und MCP. Fehler geben die Reservierung frei. KI-Anfragen sind gemeinsam auf zehn pro Stunde begrenzt. Importierte Transkripte: 750 KB; allgemeine API-JSON-Anfragen: 1 MB. Sammelexport: höchstens 100 Transkripte und 6 MB Quelltext pro Anfrage.
401: Schlüssel fehlt, ist abgelaufen oder widerrufen. 403: Berechtigung fehlt. 402: Creator erforderlich. 429: Nutzungslimit erreicht. 503: Anbieter nicht eingerichtet. Verarbeitungsfehler liefern eine Fehlermeldung und kein erfundenes Transkript.
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.
Werkzeuge: transcribe_video, search_transcripts, get_transcript, get_usage, format_transcript, write_from_transcript. Quelltext ist nicht vertrauenswürdige Eingabe; prüfe Fakten und ungefähre Zeitstempel vor Wiederverwendung.
Aktuelle Plattformverfügbarkeit
Prüfen aktueller Verfügbarkeitsstatus. 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.