Criar uma API key nomeada
1
Abra a página da API
Abra a API da Capriole AI e entre. A página mostra API keys, Playground e Usage para uma conta com acesso à API.
2
Crie e nomeie a key
Selecione Create key. O campo Name (Optional) pode identificar o cliente que a usará, como
local-codex, support-agent ou test-script.Use keys nomeadas separadas para clientes de longa duração ou membros da equipe. Isso facilita atribuir uma solicitação e permite revogar um cliente sem substituir todas as credenciais.3
Copie o secret imediatamente
Selecione Create e copie o valor do diálogo Secret key. A Capriole mostra o secret completo só depois da criação. A lista de keys exibe um valor mascarado depois.
4
Envie uma solicitação de teste
Siga o início rápido da API ou o guia dos SDKs OpenAI e Anthropic. Volte a Usage depois que a solicitação terminar.Uma resposta do modelo é útil, mas a linha de uso é a confirmação mais forte. Ela mostra que a Capriole recebeu a solicitação com a key e o modelo esperados.
Ler o saldo atual
A seção Usage separa a cota incluída atual dos tokens on-demand comprados.
O filtro Time altera as análises e as linhas de solicitação. Ele não altera o ciclo de cobrança nem recalcula o resumo da cota para a janela selecionada.
Leia Tokens cobrados da Capriole AI explicados para a fórmula de entrada em cache e a regra de arredondamento.
Filtrar o histórico de solicitações
Use os filtros para responder a uma pergunta de cada vez.
Cada linha de solicitação pode mostrar o horário, a key, o modelo, tokens de entrada, tokens em cache, tokens de saída, tokens cobrados, tokens totais, latência, status e uma mensagem de erro. Algumas métricas podem ficar indisponíveis quando uma resposta do upstream ou uma solicitação com falha não as fornece.
Verificar se um cliente usou a key pretendida
Depois de enviar uma solicitação de teste:- Defina Time como Last 24 hours.
- Selecione a Key nomeada usada pelo cliente.
- Selecione o Model esperado se vários modelos estiverem presentes.
- Defina Status como Success.
- Confirme que a nova linha tem o horário e a atividade de tokens esperados.
Desativar, reativar ou excluir uma key
Use a desativação quando estiver investigando um cliente ou interrompendo o tráfego temporariamente. Exclua uma key depois de substituí-la, ou quando a credencial puder ter sido exposta.
A lista mostra os valores Created e Last used para ajudar a identificar keys paradas. Um status exibido de Inactive significa que a key foi revogada até ser reativada.