AiVideoEditor
免费开始
菜单

审校于 2026-11-10 · API 版本 2026-11-09 · 阅读 Markdown

身份验证与产品密钥

AiVideoEditor 的 UI、REST API 和 MCP 适配器共享工作区服务。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 和请求头;不要把你的 AiVideoEditor bearer 密钥转发给存储。

作用域与账号访问

作用域能力
accounts:read检查账号、能力和 TikTok 设置
media:write预留、完成并管理上传
posts:read列出帖子、校验草稿并观察状态
posts:write创建和编辑草稿
posts:publish发布、排期、取消和重试交付
usage:read读取工作区用量和套餐信息
webhooks:manage注册、列出和移除 webhook 端点

作用域是精确名称,不是层级。只授予集成所需的作用域。密钥还可以限制可访问的账号 ID。工作区成员资格、有效角色、账号限制和套餐状态仍然适用。带有 posts:publish 的密钥不会自动获得草稿写入权限。

默认密钥作用域集省略 posts:publish 和 webhooks:manage。仅草稿代理可以在没有发送权限的情况下准备工作以供审查。密钥不能创建其他密钥或更改账单。

撤销与恢复

在开发者 UI 中撤销已泄露的密钥。先审查其待处理任务数:撤销会将未发送的工作暂停为 requires_action;它不会删除草稿。创建具有适当权限的替代密钥,并在恢复之前审查待处理的工作。不要假设撤销可以撤回已在外部发送的提交。

401 表示凭据缺失或无效。403 表示已认证的参与者缺乏权限或账号访问权。对任一响应反复重试都不会解决问题。参见错误与恢复。