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.

Solución de problemas comunes

Cuando falla una solicitud de API, use esta tabla para identificar rápidamente la causa y la solución:

Estado HTTPCausa comúnDiagnóstico y solución
401 UnauthorizedClave API no válida o caducada, o encabezado faltanteVerifique su token Bearer o encabezado x-api-key; asegúrese de que la clave esté activa en Claves API de la consola.
402 Payment RequiredSaldo insuficiente o límite de presupuesto mensual alcanzadoAgregue créditos en la consola o aumente el límite de presupuesto mensual para la clave API.
403 ForbiddenRestricción de IP, discrepancia de entorno o permisos insuficientesCompruebe el alcance de su clave API y verifique su IP de cliente contra la lista de permitidas.
404 Not FoundRuta de punto de conexión incorrecta o ID de modelo desconocidoVerifique la ruta de Base URL; llame a GET /v1/models para confirmar que el ID de modelo esté activo.
429 Too Many RequestsLímite de tasa (RPM/TPM) o concurrencia máxima alcanzadaReduzca la concurrencia; configure reintentos con retroceso exponencial; o solicite aumento de cuota en la consola.
502 Bad GatewayError de red del proveedor ascendente o respuesta malformadaLa pasarela AnyInt intenta conmutación por error entre canales automáticamente; si persiste, infórmelo mediante los registros de solicitudes de la consola.
503 Service UnavailableTodos los canales candidatos de enrutamiento están no disponibles temporalmenteReintente después de una breve pausa o cambie a un modelo de respaldo equivalente.
504 Gateway TimeoutTiempo de espera de inferencia ascendente agotado (modelos de razonamiento complejos)Revise la complejidad del prompt; aumente el tiempo de espera del cliente; habilite la transmisión (stream: true) para modelos de razonamiento.