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
| Protocolo | Entrada recomendada | Base canônica da API |
|---|---|---|
| Compatível com OpenAI | Authorization: Bearer <AnyInt API Key> | https://api.anyint.ai/openai/v1 |
| Mensagens Anthropic | x-api-key: <AnyInt API Key> | https://api.anyint.ai/anthropic/v1 |
| API do Desenvolvedor Gemini | x-goog-api-key: <AnyInt API Key> | https://api.anyint.ai/gemini/v1beta |
| Mídia assíncrona | Authorization: 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.
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.
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 HTTP | Causa comum | Solução e solução de problemas |
|---|---|---|
| 401 Unauthorized | Chave API inválida ou expirada, ou cabeçalho ausente | Verifique 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 Required | Saldo insuficiente ou limite de orçamento mensal atingido | Adicione créditos no console ou aumente o limite de orçamento mensal para a chave API. |
| 403 Forbidden | Restrição de IP, incompatibilidade de ambiente ou permissões insuficientes | Verifique o escopo da sua chave API e confira o IP do cliente na lista de permissões. |
| 404 Not Found | Caminho de endpoint incorreto ou ID de modelo desconhecido | Verifique o caminho da Base URL; chame GET /v1/models para confirmar que o modelo está ativo. |
| 429 Too Many Requests | Limite de taxa (RPM/TPM) ou teto de simultaneidade atingido | Reduza a simultaneidade; configure repetição com recuo exponencial; ou solicite aumento de cota no console. |
| 502 Bad Gateway | Erro de rede do provedor upstream ou resposta malformada | O gateway AnyInt tenta failover automático entre canais; se persistir, relate pelos logs de solicitação do console. |
| 503 Service Unavailable | Todos os canais de roteamento candidatos estão temporariamente indisponíveis | Tente novamente após breve intervalo ou mude para um modelo de backup equivalente. |
| 504 Gateway Timeout | Tempo 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. |