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.

Solução de problemas de erros comuns

Quando uma solicitação de API falha, use esta tabela para identificar rapidamente a causa e a solução:

Status HTTPCausa comumSolução e solução de problemas
401 UnauthorizedChave API inválida ou expirada, ou cabeçalho ausenteVerifique seu token Bearer ou cabeçalho x-api-key; certifique-se de que a chave esteja ativa em Chaves de API do console.
402 Payment RequiredSaldo insuficiente ou limite de orçamento mensal atingidoAdicione créditos no console ou aumente o limite de orçamento mensal para a chave API.
403 ForbiddenRestrição de IP, incompatibilidade de ambiente ou permissões insuficientesVerifique o escopo da sua chave API e confira o IP do cliente na lista de permissões.
404 Not FoundCaminho de endpoint incorreto ou ID de modelo desconhecidoVerifique o caminho da Base URL; chame GET /v1/models para confirmar que o modelo está ativo.
429 Too Many RequestsLimite de taxa (RPM/TPM) ou teto de simultaneidade atingidoReduza a simultaneidade; configure repetição com recuo exponencial; ou solicite aumento de cota no console.
502 Bad GatewayErro de rede do provedor upstream ou resposta malformadaO gateway AnyInt tenta failover automático entre canais; se persistir, relate pelos logs de solicitação do console.
503 Service UnavailableTodos os canais de roteamento candidatos estão temporariamente indisponíveisTente novamente após breve intervalo ou mude para um modelo de backup equivalente.
504 Gateway TimeoutTempo limite de inferência upstream esgotado (modelos de raciocínio complexos)Verifique a complexidade do prompt; aumente o tempo limite do cliente; ative streaming (stream: true) para modelos de raciocínio.