Chaves de API

As chaves de API autenticam suas requisições à API do VocalLab. O acesso à API exige um plano Studio.

Criar uma chave

1. Acesse as Configurações de desenvolvedor.
2. Insira um nome (por exemplo, "Production" ou "Zapier") e clique em Create key.
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

Nas Configurações de desenvolvedor, clique em Revoke 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 Studio terminar, as chaves param de funcionar até que você esteja no Studio novamente (elas não são excluídas).

Limites

• Até 5 chaves ativas por conta.
• 60 requisições por minuto por chave.