Geprüft am 2026-11-10 · API-Version 2026-11-09 · Markdown lesen
Authentifizierung und Produktkeys
AiVideoEditors UI, REST-API und MCP-Adapter teilen sich die Arbeitsbereichsdienste. API-Clients
verwenden einen Produktkey, kein OAuth-Token eines sozialen Netzwerks und keine Datenbank-Zugangsdaten.
Erstelle Keys unter /app/developers, nachdem du dich im richtigen Arbeitsbereich angemeldet hast. Kopiere
den Klartext-Key pk_v1_… einmalig und speichere ihn in einem Secret-Manager oder einer geschützten
lokalen Umgebung. AiVideoEditor behält einen Hash und einen Anzeige-Präfix.
Einen Key senden
curl --fail-with-body -sS \
-H "Authorization: Bearer $PUBLISHER_KEY" \
"$PUBLISHER_API_URL/api/v1/usage"
Verwende HTTPS für eine bereitgestellte Origin. Halte Zugangsdaten fern von URLs, Quellcodeverwaltung, Chat-Prompts, Screenshots und Logs. Direkte Storage-Uploads verwenden die zurückgegebene signierte URL und die zugehörigen Header; leite deinen AiVideoEditor-Bearer-Key nicht an den Storage weiter.
Scopes und Kontozugriff
| Scope | Fähigkeit |
|---|---|
accounts:read | Konten, Capabilities und TikTok-Einstellungen einsehen |
media:write | Uploads reservieren, finalisieren und verwalten |
posts:read | Beiträge auflisten, Entwürfe validieren und den Status beobachten |
posts:write | Entwürfe erstellen und bearbeiten |
posts:publish | Zustellungen veröffentlichen, planen, abbrechen und wiederholen |
usage:read | Arbeitsbereichs-Nutzung und Plan-Informationen lesen |
webhooks:manage | Webhook-Endpunkte registrieren, auflisten und entfernen |
Scopes sind exakte Namen, keine Hierarchie. Gewähre nur die, die die Integration benötigt.
Keys können außerdem zugängliche Konto-IDs einschränken. Arbeitsbereichs-Mitgliedschaft, effektive
Rolle, Konto-Einschränkungen und Plan-Status gelten weiterhin. Ein Key mit
posts:publish erhält nicht automatisch Schreibzugriff auf Entwürfe.
Der Standard-Scope-Satz eines Keys lässt posts:publish und webhooks:manage weg. Ein Draft-only-
Agent kann Arbeit zur Prüfung vorbereiten, ohne die Befugnis zu haben, sie zu senden. Keys können
keine anderen Keys erstellen oder die Abrechnung ändern.
Widerruf und Wiederherstellung
Widerrufe einen kompromittierten Key in der Entwickler-UI. Prüfe zuerst die Anzahl seiner ausstehenden Jobs:
der Widerruf pausiert ungesendete Arbeit als requires_action; er löscht keine Entwürfe.
Erstelle einen Ersatz mit passendem Zugriff und prüfe ausstehende Arbeit, bevor du fortfährst. Gehe nicht davon aus,
dass ein Widerruf eine bereits extern gesendete Übermittlung zurückrufen kann.
Eine 401 bedeutet, dass Zugangsdaten fehlen oder ungültig sind. Eine 403 bedeutet, dass dem
authentifizierten Akteur die Berechtigung oder der Kontozugriff fehlt. Beide Antworten wiederholt
zu wiederholen wird das Problem nicht beheben. Siehe Fehler und Wiederherstellung.