Проверено 2026-11-10 · версия API 2026-11-09 · Читать Markdown
Аутентификация и ключи продукта
UI, REST API и MCP-адаптер AiVideoEditor используют общие сервисы рабочего пространства. API-клиенты
используют ключ продукта, а не OAuth-токен социальной сети или учетную запись базы данных.
Создавайте ключи в /app/developers после входа в правильное рабочее пространство. Скопируйте
открытый ключ pk_v1_… один раз и сохраните его в менеджере секретов или защищенной
локальной среде. AiVideoEditor хранит хеш и префикс для отображения.
Отправка ключа
curl --fail-with-body -sS \
-H "Authorization: Bearer $PUBLISHER_KEY" \
"$PUBLISHER_API_URL/api/v1/usage"
Для развернутого источника используйте HTTPS. Держите учетные данные вдали от URL, системы контроля версий, чат-промптов, скриншотов и логов. Прямые загрузки в хранилище используют возвращенный подписанный URL и заголовки; не пересылайте свой bearer-ключ AiVideoEditor в хранилище.
Права (scopes) и доступ к аккаунтам
| Право (scope) | Возможность |
|---|---|
accounts:read | Просмотр аккаунтов, возможностей и настроек TikTok |
media:write | Резервирование, финализация и управление загрузками |
posts:read | Списки постов, проверка черновиков и наблюдение за статусом |
posts:write | Создание и правка черновиков |
posts:publish | Публикация, планирование, отмена и повтор доставок |
usage:read | Чтение использования и информации о тарифе рабочего пространства |
webhooks:manage | Регистрация, список и удаление эндпоинтов вебхуков |
Права (scopes) — это точные имена, а не иерархия. Выдавайте только те, которые нужны интеграции.
Ключи могут также ограничивать доступные ID аккаунтов. Участие в рабочем пространстве,
действующая роль, ограничения аккаунтов и состояние тарифа по-прежнему применяются. Ключ с
posts:publish не получает автоматически доступ на запись черновиков.
Набор прав ключа по умолчанию не включает posts:publish и webhooks:manage. Агент
только для черновиков может готовить работу для проверки без полномочий на ее отправку. Ключи не могут
создавать другие ключи или изменять биллинг.
Отзыв и восстановление
Отзовите скомпрометированный ключ в интерфейсе разработчика. Сначала просмотрите число его ожидающих заданий:
отзыв приостанавливает неотправленную работу в статусе requires_action; он не удаляет черновики.
Создайте замену с подходящим доступом и просмотрите ожидающую работу перед продолжением.
Не считайте, что отзыв может отозвать уже отправленную вовне публикацию.
401 означает, что учетные данные отсутствуют или недействительны. 403 означает, что
аутентифицированный субъект не имеет прав или доступа к аккаунту. Многократный повтор
любого из этих ответов проблему не решит. См. ошибки и восстановление.