Autenticación

Autentica de forma segura cada protocolo de API compatible con una clave de API de AnyInt.

Cada solicitud a la API para desarrolladores requiere una clave de API de AnyInt activa. Utiliza la cabecera esperada por tu protocolo cliente para que los SDK existentes de OpenAI, Anthropic y Gemini sigan funcionando.

Autenticación recomendada por protocolo

ProtocoloEntrada recomendadaBase de API canónica
Compatible con OpenAIAuthorization: Bearer <AnyInt API Key>https://api.anyint.ai/openai/v1
Anthropic Messagesx-api-key: <AnyInt API Key>https://api.anyint.ai/anthropic/v1
Gemini Developer APIx-goog-api-key: <AnyInt API Key>https://api.anyint.ai/gemini/v1beta
Medios asíncronosAuthorization: Bearer <AnyInt API Key>https://api.anyint.ai/v1/async-tasks

Para compatibilidad con el cliente, la pasarela también acepta las cabeceras de clave de AnyInt compatibles en todas las familias de protocolos y acepta el parámetro de consulta key de Gemini en las rutas de Gemini. Prefiere las cabeceras para que las credenciales no aparezcan en las URL ni en los registros intermedios.

La pasarela consume la credencial de AnyInt antes de enrutar al proveedor. Nunca reenvía esa credencial como clave de proveedor upstream. Las claves inválidas, caducadas o revocadas fallan de forma segura.

Crear una clave

Crea una clave de API en la Consola, luego guárdala en un gestor de secretos del lado del servidor o en una variable de entorno.

Las claves de AnyInt recién emitidas utilizan el prefijo sk- seguido de 52 caracteres Base64URL (55 caracteres en total). Las claves ak_ existentes seguirán siendo válidas hasta que las rotes o deshabilites. Copia siempre el valor completo que muestra la Consola; no añadas ni elimines un prefijo tú mismo.

bash
export ANYINT_API_KEY="your_api_key"

Directrices de seguridad

  • Guarda las claves en un gestor de secretos del lado del servidor o en una variable de entorno.
  • Nunca coloques una clave en JavaScript del lado del cliente, control de código fuente, registros o URL.
  • Utiliza una clave separada para cada aplicación y entorno.
  • Rota una clave inmediatamente si se ha podido exponer.
  • No reenvíes las claves de AnyInt a proveedores upstream.

Probar la autenticación

Lista los modelos para verificar la clave antes de enviar una solicitud de inferencia.

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

Un fallo de autenticación devuelve HTTP 401 con un error con formato de protocolo. Una clave válida aún puede recibir 402 por saldo insuficiente o 503 cuando no hay un proveedor elegible disponible.