Revisado em 2026-11-10 · Versão da API 2026-11-09 · Ler Markdown
Autenticação e chaves de produto
A UI, a API REST e o adaptador MCP do AiVideoEditor compartilham os serviços do espaço de trabalho. Os clientes da API
usam uma chave de produto, não um token OAuth de rede social nem uma credencial de banco de dados.
Crie chaves em /app/developers depois de entrar no espaço de trabalho correto. Copie
a chave em texto puro pk_v1_… uma única vez e armazene-a em um gerenciador de segredos ou em um
ambiente local protegido. O AiVideoEditor retém um hash e um prefixo de exibição.
Enviar uma chave
curl --fail-with-body -sS \
-H "Authorization: Bearer $PUBLISHER_KEY" \
"$PUBLISHER_API_URL/api/v1/usage"
Use HTTPS em uma origem implantada. Mantenha as credenciais longe de URLs, controle de versão, prompts de chat, capturas de tela e logs. Os uploads diretos para o armazenamento usam a URL assinada e os cabeçalhos retornados; não encaminhe sua chave bearer do AiVideoEditor ao armazenamento.
Escopos e acesso a contas
| Escopo | Capacidade |
|---|---|
accounts:read | Inspecionar contas, capacidades e configurações do TikTok |
media:write | Reservar, finalizar e gerenciar uploads |
posts:read | Listar publicações, validar rascunhos e observar o status |
posts:write | Criar e editar rascunhos |
posts:publish | Publicar, agendar, cancelar e repetir entregas |
usage:read | Ler o uso do espaço de trabalho e as informações do plano |
webhooks:manage | Registrar, listar e remover endpoints de webhook |
Os escopos são nomes exatos, não uma hierarquia. Conceda apenas os que a integração precisa.
As chaves também podem restringir os IDs de conta acessíveis. A membership no espaço de trabalho,
o papel efetivo, as restrições de conta e o estado do plano continuam valendo. Uma chave com
posts:publish não ganha automaticamente acesso de escrita de rascunhos.
O conjunto de escopos padrão da chave omite posts:publish e webhooks:manage. Um agente
somente para rascunhos pode preparar trabalho para revisão sem autoridade para enviá-lo. As chaves não podem
criar outras chaves nem alterar cobranças.
Revogação e recuperação
Revogue uma chave comprometida na UI do desenvolvedor. Revise primeiro a contagem de trabalhos pendentes:
a revogação pausa o trabalho não enviado como requires_action; ela não exclui rascunhos.
Crie uma substituição com o acesso apropriado e revise o trabalho pendente antes de
retomar. Não presuma que a revogação pode recolher um envio já enviado externamente.
Um 401 significa que as credenciais estão ausentes ou inválidas. Um 403 significa que o
ator autenticado não tem permissão ou acesso à conta. Repetir qualquer uma dessas respostas
repetidamente não resolverá o problema. Consulte erros e recuperação.