AiVideoEditor
Kostenlos starten
Menü

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

ScopeFähigkeit
accounts:readKonten, Capabilities und TikTok-Einstellungen einsehen
media:writeUploads reservieren, finalisieren und verwalten
posts:readBeiträge auflisten, Entwürfe validieren und den Status beobachten
posts:writeEntwürfe erstellen und bearbeiten
posts:publishZustellungen veröffentlichen, planen, abbrechen und wiederholen
usage:readArbeitsbereichs-Nutzung und Plan-Informationen lesen
webhooks:manageWebhook-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.