审校于 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 表示已认证的参与者缺乏权限或账号访问权。对任一响应反复重试都不会解决问题。参见错误与恢复。