Verificador de claves de API

Cuando una herramienta de IA no logra conectarse a la API de un modelo, la causa suele ser una de pocas: una URL base a la que le falta o le sobra parte de la ruta, una clave de otro proveedor, un ID de modelo que no existe o un navegador que bloquea la solicitud. Este verificador envía las mismas solicitudes que haría tu herramienta, desde tu navegador, y te dice cuál es. Funciona con cualquier API que siga el formato de OpenAI, no solo con cheapaimodel.

1. 01Limpiar la URL base

   Antes de enviar nada, la dirección se limpia con las reglas de abajo, para que un pequeño error de escritura no oculte el problema real. A los hosts que sabemos que necesitan /v1 (OpenAI y cheapaimodel) se les agrega; en otros hosts solo te lo señalamos, porque algunos proveedores funcionan sin él.

   Correcciones de la URL base

   • https://api.example.com/v1Agregamos https://.
   • http://localhost:11434/v1Agregamos http://.
   • https://api.example.com/v1Cambiamos http:// por https://. Una página servida por HTTPS no puede llamar a HTTP simple; si tu servidor solo usa HTTP, pruébalo con curl.
   • https://api.example.com/v1/chat/completionsQuitamos /chat/completions del final: tu herramienta lo agrega a cada solicitud.
   • https://api.example.com//v1/Quitamos las barras de más.
   • https://api.example.com/v1/v1/v1 aparecía dos veces; dejamos uno.
   • https://api.example.com/v1?key=abcQuitamos la cadena de consulta o el fragmento #.
   • https://api.openai.com/v1Agregamos /v1, que esta API requiere.
   • https://apiconsole.cheapaimodel.ai/v1Esa es nuestra página web, no la API. La cambiamos por la dirección de la API.

2. 02Listar modelos

   Envía GET <base_url>/models con tu clave en el encabezado Authorization. No cuesta nada y muestra que la dirección y la clave funcionan juntas. La solicitud se cancela después de 15 segundos.

3. 03Enviar un mensaje de prueba (opcional)

   Solo cuando presionas el botón: una chat completion en streaming que pide “Reply with OK.” con max_tokens 16. El primer token es el tiempo desde el envío hasta que llega el primer fragmento del stream; el total corre hasta que termina el stream. Si el modelo rechaza max_tokens, se envía una vez más con max_completion_tokens. La solicitud se cancela después de 30 segundos.

4. 04Interpretar la respuesta

   Un código de error en la respuesta pesa más que el estado HTTP: model_not_found significa un ID de modelo incorrecto e insufficient_quota, que no hay crédito. Si no hay código, decide el estado: 401 es la clave, 403 es un permiso o el saldo, 404 es la ruta, 429 es un límite de solicitudes y 5xx es el proveedor. Un 404 en texto plano suele significar que falta /v1, y una página HTML, que escribiste la dirección de un sitio web en lugar de la API.

5. 05Distinguir CORS de un servidor caído

   Si el navegador no deja ver la respuesta, la página envía una solicitud más a la misma dirección en modo no-cors, sin tu clave. Si el servidor contesta, está en línea pero bloquea las páginas web (CORS), y la forma de probarlo es con el comando curl. Si no contesta, no se puede llegar a él desde tu red.

6. A dónde va tu clave

   Las solicitudes van directo de esta página a la URL base que escribiste. La clave solo vive en la memoria de esta página: no se envía a cheapaimodel, no se guarda en el navegador ni se pone en la barra de direcciones, y desaparece al cerrar la pestaña. El comando curl la oculta, a menos que elijas mostrarla.

• Clave rechazada (401)

  El servidor no acepta esta clave de API. Puede estar mal escrita, revocada o vencida, o ser de un proveedor distinto al de esta URL base. Vuelve a copiar la clave sin espacios y confirma que sea de este proveedor.

• Acceso denegado (403)

  La clave es válida, pero no tiene permiso para esta llamada: puede haber restricciones en el modelo, tu dirección IP o la cuenta, o el saldo puede ser insuficiente.

• No es una ruta de API (404)

  El servidor respondió con un 404 en texto plano en lugar de un error de API. Casi siempre a la URL base le falta /v1.

• Modelo no encontrado

  Esta clave no tiene disponible ningún modelo con este ID. Los ID deben coincidir exactamente: copia uno de la lista de arriba o de la página de modelos del proveedor.

• Límite de solicitudes (429)

  Demasiadas solicitudes, o esta clave alcanzó el límite del proveedor. Espera un momento y vuelve a intentarlo; si sigue pasando, revisa los límites de solicitudes del proveedor.

• Bloqueado por el navegador (CORS)

  El servidor responde, pero no deja que las páginas web lean sus respuestas. Esto no dice nada de tu clave: ejecuta el comando curl de abajo en una terminal para ver la respuesta real.

• Se agotó el tiempo

  No hubo respuesta en 15 segundos. Puede que el servidor esté saturado o que la dirección apunte a algo que nunca responde.