Como obter e gerenciar sua API key

Pedir uma chave

  1. Acesse o formulário de pedido de chave no portal.
  2. Preencha o formulário com:
    • Como pretende usar: descreva o projeto (orientador, prazo, dados).
    • Serviços: marque OCR, transcrição, estruturação ou análise de viabilidade.
    • Volume estimado: ordem de grandeza (ex.: “5 mil PDFs”, “20h de áudio”).
  3. A equipe LabDados revisa em até 1 semana. Aprovado → você recebe a chave por e-mail.
Aviso

A chave é mostrada uma única vez no e-mail. Se perder, peça uma nova — não temos como recuperar.

Como guardar

A chave é um segredo equivalente a uma senha. Algumas práticas:

  • Não cole em scripts versionados no GitHub. Use uma variável de ambiente:

    export LABDADOS_API_KEY="sk_lab_..."
    import os
import labdados
client = labdados.Client(api_key=os.environ["LABDADOS_API_KEY"])

  • Em notebooks: use getpass.getpass() para colar sem ecoar a chave:

    import getpass, labdados
client = labdados.Client(api_key=getpass.getpass("API key: "))

  • Em laboratórios compartilhados: cada pessoa pede a própria chave. As Requests ficam vinculadas à chave que as criou — assim cada pessoa só vê os próprios pedidos.

Revogar / renovar

Caso suspeite que a chave vazou, escreva pra ou abra um novo pedido no formulário pedindo a revogação. Após revogar, Client.test_connection() passa a retornar ApiKeyError (HTTP 403).

Limites de uso

  • Rate limit padrão: definido em runtime pelo backend. Em geral, o SDK respeita o 429 automaticamente esperando alguns segundos antes da próxima tentativa.
  • Cota mensal: cada chave tem um orçamento de R$50/mês de compute na nossa infra (default). O custo estimado de cada job é debitado do saldo. Quando você manda uma pasta com 1.000 PDFs e o saldo restante só cobre 200, o backend processa os 200 que cabem e anota no e-mail/Request.notes quantos ficaram fora — não falha o pedido inteiro. O ciclo reseta no dia 1 de cada mês.
  • Volumes muito grandes: combine com a equipe antes — para coletas com centenas de milhares de documentos, vale planejar slots de GPU e/ou ajustar o orçamento mensal.