Vérifié le 2026-11-10 · Version API 2026-11-09 · Lire le Markdown
Authentification et clés de produit
L'UI d'AiVideoEditor, l'API REST et l'adaptateur MCP partagent les services de l'espace de travail. Les clients
API utilisent une clé de produit, pas un jeton OAuth de réseau social ni un identifiant de base de données.
Créez les clés à /app/developers après vous être connecté au bon espace de travail. Copiez la clé en clair
pk_v1_… une seule fois et stockez-la dans un gestionnaire de secrets ou un environnement local protégé.
AiVideoEditor conserve un hash et un préfixe d'affichage.
Envoyer une clé
curl --fail-with-body -sS \
-H "Authorization: Bearer $PUBLISHER_KEY" \
"$PUBLISHER_API_URL/api/v1/usage"
Utilisez HTTPS pour une origine déployée. Gardez les identifiants hors des URL, du contrôle de source, des prompts de chat, des captures d'écran et des journaux. Les téléversements directs vers le stockage utilisent l'URL signée et les en-têtes retournés ; ne transmettez pas votre clé bearer AiVideoEditor au stockage.
Scopes et accès aux comptes
| Scope | Capacité |
|---|---|
accounts:read | Inspecter les comptes, les capacités et les réglages TikTok |
media:write | Réserver, finaliser et gérer les téléversements |
posts:read | Lister les publications, valider les brouillons et observer le statut |
posts:write | Créer et modifier des brouillons |
posts:publish | Publier, planifier, annuler et retenter les livraisons |
usage:read | Lire l'utilisation de l'espace de travail et les informations de plan |
webhooks:manage | Enregistrer, lister et supprimer des points de terminaison webhook |
Les scopes sont des noms exacts, pas une hiérarchie. N'accordez que ceux dont l'intégration a besoin.
Les clés peuvent aussi restreindre les IDs de comptes accessibles. L'appartenance à l'espace de travail,
le rôle effectif, les restrictions de compte et l'état du plan s'appliquent toujours. Une clé avec
posts:publish n'obtient pas automatiquement l'accès en écriture des brouillons.
L'ensemble de scopes par défaut des clés omet posts:publish et webhooks:manage. Un agent limité aux
brouillons peut préparer du travail pour revue sans avoir l'autorité de l'envoyer. Les clés ne peuvent pas
créer d'autres clés ni modifier la facturation.
Révocation et récupération
Révoquez une clé compromise dans l'UI développeur. Examinez d'abord son nombre de tâches en attente :
la révocation met en pause le travail non envoyé en tant que requires_action ; elle ne supprime pas les
brouillons. Créez un remplacement avec les accès appropriés et examinez le travail en attente avant de
reprendre. Ne partez pas du principe que la révocation peut rappeler une soumission déjà envoyée à l'externe.
Un 401 signifie que les identifiants sont absents ou invalides. Un 403 signifie que l'acteur
authentifié manque de permission ou d'accès au compte. Retenter à répétition l'une ou l'autre réponse
ne corrigera rien. Voir erreurs et récupération.