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
| Protocolo | Entrada recomendada | Base de API canónica |
|---|---|---|
| Compatible con OpenAI | Authorization: Bearer <AnyInt API Key> | https://api.anyint.ai/openai/v1 |
| Anthropic Messages | x-api-key: <AnyInt API Key> | https://api.anyint.ai/anthropic/v1 |
| Gemini Developer API | x-goog-api-key: <AnyInt API Key> | https://api.anyint.ai/gemini/v1beta |
| Medios asíncronos | Authorization: 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.
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.
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 HTTP | Causa común | Diagnóstico y solución |
|---|---|---|
| 401 Unauthorized | Clave API no válida o caducada, o encabezado faltante | Verifique su token Bearer o encabezado x-api-key; asegúrese de que la clave esté activa en Claves API de la consola. |
| 402 Payment Required | Saldo insuficiente o límite de presupuesto mensual alcanzado | Agregue créditos en la consola o aumente el límite de presupuesto mensual para la clave API. |
| 403 Forbidden | Restricción de IP, discrepancia de entorno o permisos insuficientes | Compruebe el alcance de su clave API y verifique su IP de cliente contra la lista de permitidas. |
| 404 Not Found | Ruta de punto de conexión incorrecta o ID de modelo desconocido | Verifique la ruta de Base URL; llame a GET /v1/models para confirmar que el ID de modelo esté activo. |
| 429 Too Many Requests | Límite de tasa (RPM/TPM) o concurrencia máxima alcanzada | Reduzca la concurrencia; configure reintentos con retroceso exponencial; o solicite aumento de cuota en la consola. |
| 502 Bad Gateway | Error de red del proveedor ascendente o respuesta malformada | La 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 Unavailable | Todos los canales candidatos de enrutamiento están no disponibles temporalmente | Reintente después de una breve pausa o cambie a un modelo de respaldo equivalente. |
| 504 Gateway Timeout | Tiempo 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. |