Chaves de API

As chaves de API autenticam suas requisições à API do VocalLab. O acesso à API está incluído nos planos Pro e Max.

Criar uma chave

1. No VocalLab Studio, clique em API e MCP na barra lateral (você também pode usar a página Developer do vocallab.ai).
2. Insira um nome para a chave (por exemplo, "Production" ou "Zapier") e crie a chave.
3. Copie a chave imediatamente — ela começa com vl_live_ e é exibida apenas uma vez. Armazenamos apenas uma versão com hash e não podemos exibi-la novamente.

Usar uma chave

Envie-a como um token Bearer em cada requisição:

curl https://api.vocallab.ai/api/v1/ping \
  -H "Authorization: Bearer vl_live_..."

Revogar uma chave

Na página API e MCP (ou em Developer), clique em Revogar ao lado de uma chave. Ela deixa de funcionar imediatamente. Se uma chave for vazada, revogue-a e crie uma nova.

Boas práticas

• Armazene as chaves em variáveis de ambiente ou em um gerenciador de segredos — nunca no código ou no git.
• Use uma chave separada para cada aplicativo ou integração, para poder revogar uma sem afetar as outras.
• Se o seu plano Pro ou Max terminar, as chaves param de funcionar até que você volte a um plano com acesso à API (elas não são excluídas).

Limites

• Até 5 chaves ativas por conta.
• 60 requisições por minuto por chave (120 no plano Max).