Autenticação
Chaves de API
As requisições de inferência autenticam-se com uma chave de API UberLLM. As chaves começam com ull_
seguido por um sufixo aleatório. Passe-a como um bearer token:
Authorization: Bearer ull_your_key_here
A superfície Anthropic também aceita a chave no cabeçalho x-api-key.
Sua primeira chave é criada para você na sua primeira visita ao painel e exibida lá com uma primeira chamada que você pode colar. Crie, edite, liste e exclua chaves em Painel → Chaves de API. O segredo completo é exibido uma única vez na criação — armazene-o imediatamente; a UberLLM mantém apenas um hash e nunca poderá exibi-lo novamente. Excluir uma chave (Painel → Chaves de API → Excluir) entra em vigor imediatamente: aplicativos que a usam param de funcionar, e seu uso passado permanece em seus totais.
Controles por chave
Cada chave pode ter suas próprias salvaguardas, definidas ao criá-la ou posteriormente com Editar em Painel → Chaves de API. Uma alteração se aplica à próxima solicitação da chave.
- Limite de gastos — um teto em USD ao longo de uma janela de
daily,monthlyoulifetime. Solicitações que o excederiam são rejeitadas com402 key_spend_cap_exceeded. Vazio significa sem limite. - Limite diário —
daily_limit_usd, além do limite de gastos. Uma solicitação deve se encaixar em ambos, e o limite diário é redefinido à meia-noite UTC. Uma solicitação acima de qualquer um dos limites é recusada com402 key_spend_cap_exceedede nada é cobrado. Defina-o na página Chaves ou comPATCH /api/v1/keys/{id}. - Limite de taxa — um teto de solicitações por minuto (1 a 10,000). Vazio significa o limite padrão por chave (300 por minuto).
- Provedor BYOK — fixe a chave para rotear através de sua própria credencial de provedor (veja abaixo).
E-mail de saldo baixo
Em Dashboard → Créditos, você pode solicitar ser notificado por e-mail quando seu saldo cair abaixo de um valor que você escolher. Por padrão, está desativado, envia um e-mail cada vez que o saldo cai abaixo desse valor e é enviado aos proprietários da conta. Se o dinheiro reservado para uma solicitação de imagem, vídeo, música ou fala ainda estiver retido 15 minutos após o término do trabalho, os proprietários da conta recebem um e-mail listando esses trabalhos e nossa equipe é informada. Esse dinheiro ainda é seu e será liberado.
BYOK — traga sua própria chave
Adicione uma credencial de provedor em Dashboard → BYOK. As requisições roteadas através de um provedor BYOK usam sua credencial diretamente; nenhum crédito é reservado e o custo por token é zero no seu saldo UberLLM. As credenciais armazenadas são criptografadas e são exibidas apenas como um último-4 mascarado.
Sessões do Dashboard
Você acessa o dashboard web com o Google (um clique: o prompt "Continuar como" em
uberllm.dev, ou o botão do Google), ou com seu e-mail: enviamos um
código de 6 dígitos (e um link de login) que expira em 15 minutos. Não há
senha. O login gera uma sessão de curta duração, armazenada em um cookie httpOnly. Esta sessão é separada das suas
ull_ inference keys — os endpoints do dashboard em /api/v1/* usam o cookie;
o gateway (/v1/*) usa a API key.
Erros
Falhas de autenticação retornam um envelope de erro no estilo OpenAI:
{ "error": { "code": "invalid_api_key", "message": "…", "type": "authentication_error" } }
Veja Erros e limites para a lista completa.