Autenticação
Chaves de API
As requisições de inferência autenticam-se com uma chave de API MartLLM. 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 MartLLM 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 quando você a cria ou posteriormente com Editar em Dashboard → API keys. Uma alteração se aplica à próxima requisição da chave.
- Limite de gastos — um teto em USD durante uma janela de
daily,monthlyoulifetime. Requisiçõ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 requisição deve se encaixar em ambos, e o limite diário é redefinido à meia-noite UTC. Uma requisição que exceda 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 requisições por minuto (1 a 10,000). Vazio significa o limite padrão por chave (300 por minuto).
- Não salvar minhas requisições e respostas — desativado por padrão: MartLLM mantém cada requisição e sua resposta por 90 dias para corrigir requisições falhas e responder a perguntas de suporte. Ative-o e as chamadas feitas com a chave não serão salvas. Mantemos apenas o registro de cada chamada (hora, modelo, contagem de tokens, custo, o endereço de origem, os provedores que tentamos e quaisquer erros que eles retornaram), não o que você enviou ou o que voltou, então não podemos investigar uma resposta errada para você. Trabalhos de vídeo e música ainda mantêm suas requisições, então um trabalho que um provedor abandona pode ser iniciado novamente. O provedor que atende uma requisição a recebe de qualquer forma. Defina-o na página Chaves, ou com
no_store(true/false) emPOST /api/v1/keysePATCH /api/v1/keys/{id};GET /api/v1/keyso retorna. - Provedor BYOK — fixe a chave para rotear através da 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 MartLLM. 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
martllm.com, 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.