Autenticação

Autentique cada protocolo de API suportado com segurança usando uma chave de API AnyInt.

Cada solicitação da API do Desenvolvedor requer uma chave de API AnyInt ativa. Use o cabeçalho esperado pelo seu protocolo cliente para que os SDKs existentes da OpenAI, Anthropic e Gemini continuem funcionando.

Autenticação Recomendada por Protocolo

ProtocoloEntrada recomendadaBase canônica da API
Compatível com OpenAIAuthorization: Bearer <AnyInt API Key>https://api.anyint.ai/openai/v1
Mensagens Anthropicx-api-key: <AnyInt API Key>https://api.anyint.ai/anthropic/v1
API do Desenvolvedor Geminix-goog-api-key: <AnyInt API Key>https://api.anyint.ai/gemini/v1beta
Mídia assíncronaAuthorization: Bearer <AnyInt API Key>https://api.anyint.ai/v1/async-tasks

Para compatibilidade com o cliente, o gateway também aceita os cabeçalhos de chave AnyInt suportados em todas as famílias de protocolos e aceita o parâmetro de consulta key do Gemini em rotas Gemini. Prefira cabeçalhos para que as credenciais não apareçam em URLs ou logs intermediários.

O gateway consome a credencial AnyInt antes do roteamento do provedor. Ele nunca encaminha essa credencial como uma chave de provedor upstream. Chaves inválidas, expiradas ou revogadas falham fechadas.

Criar uma Chave

Crie uma chave de API no Console, em seguida, armazene-a em um gerenciador de segredos do lado do servidor ou variável de ambiente.

Chaves AnyInt recém-emitidas usam o prefixo sk- seguido por 52 caracteres Base64URL (55 caracteres no total). Chaves ak_ existentes permanecem válidas até que você as rotacione ou desabilite. Sempre copie o valor completo mostrado pelo Console; não adicione ou remova um prefixo você mesmo.

bash
export ANYINT_API_KEY="your_api_key"

Diretrizes de Segurança

  • Armazene chaves em um gerenciador de segredos do lado do servidor ou variável de ambiente.
  • Nunca coloque uma chave em JavaScript frontend, controle de origem, logs ou URLs.
  • Use uma chave separada para cada aplicativo e ambiente.
  • Rotacione uma chave imediatamente se ela puder ter sido exposta.
  • Não encaminhe chaves AnyInt para provedores upstream.

Testar Autenticação

Liste os modelos para verificar a chave antes de enviar uma solicitação de inferência.

bash
curl "https://api.anyint.ai/openai/v1/models" \
  --header "Authorization: Bearer $ANYINT_API_KEY"

Uma falha de autenticação retorna HTTP 401 com um erro no formato do protocolo. Uma chave válida ainda pode receber 402 por saldo insuficiente ou 503 quando nenhum provedor elegível estiver disponível.