Probador de clave de API de IA: verifica una clave en 30 segundos

Por qué probar localmente en lugar de en una página web

Buscar un probador de clave de API de IA devuelve muchas páginas donde pegas una clave y presionas un botón. Evítalas. Una clave es una contraseña que gasta tu dinero, y no sabes qué hace una página así con ella. Las pruebas siguientes tardan medio minuto, se ejecutan en tu propia máquina y envían la clave solo a la API que deseas usar.

Necesitas tres cosas: la clave, la URL base https://api.getaiapikey.com/v1 y el ID del modelo uncensored. Coloca la clave en una variable de entorno para que no termine en el historial de tu shell o en un archivo que puedas hacer commit.

Copyexport API_KEY="paste-your-key-here"

Las claves se obtienen desde la página de clave de API. Si aún no tienes una, los nuevos usuarios pueden reclamar $0,50 de crédito de prueba con un solo clic después de registrarse, lo cual es más que suficiente para realizar todas las pruebas de este artículo muchas veces.

Comprobación 1: listar modelos con curl

La prueba más barata es la lista de modelos. Necesita una clave válida y una URL base correcta, y no genera ningún texto.

Copycurl -i https://api.getaiapikey.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

La bandera -i imprime los encabezados de la respuesta. Una respuesta saludable comienza con HTTP/2 200 y un cuerpo JSON que incluye el ID del modelo uncensored. Si ves un error de autenticación en su lugar, normalmente el estado 401, la clave es incorrecta, se copió con un espacio al final o falta la palabra Bearer. Un 404 significa que la URL es incorrecta, lo más probable es que falte /v1 o que esté duplicada.

Comprobación 2: ejecutar una finalización real

Una clave puede ser válida y aún así fallar en una petición real, por ejemplo porque el saldo está vacío. Entonces envía una llamada de chat pequeña y limita la salida para mantener el costo cerca de cero:

Copycurl -i https://api.getaiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","max_tokens":5,"messages":[{"role":"user","content":"Say ok."}]}'

Lee los encabezados antes del cuerpo. X-Request-Id identifica la llamada, que es lo que solicita el soporte. X-Balance-USD muestra cuánto crédito queda. X-RateLimit-Limit-Requests y X-RateLimit-Limit-Concurrency revelan los límites de tu clave: 300 y 8 para una clave completa, 60 y 2 para una clave de prueba. Esa única llamada verifica por tanto la autenticación, el modelo, el saldo y el tipo de clave.

El precio de la prueba es insignificante. Un prompt de aproximadamente 10 tokens y una respuesta de 5 tokens cuestan 10 x $0,15 / 1M + 5 x $0,50 / 1M, que es aproximadamente $0,000004. Las peticiones fallidas o rechazadas no se cobran en absoluto.

Comprobación 3: la misma prueba en Python

Si tu código real usa Python, pruébalo de la manera en que se ejecutará el código. Este script usa el paquete oficial openai, por lo que un paso aquí significa que la configuración de tu aplicación también funciona:

Copyimport os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.getaiapikey.com/v1",
    api_key=os.environ["API_KEY"],
)

raw = client.chat.completions.with_raw_response.create(
    model="uncensored",
    max_tokens=5,
    messages=[{"role": "user", "content": "Say ok."}],
)
print("status:", raw.status_code)
print("balance:", raw.headers.get("X-Balance-USD"))
print("req/min limit:", raw.headers.get("X-RateLimit-Limit-Requests"))
print("concurrency limit:", raw.headers.get("X-RateLimit-Limit-Concurrency"))
print("reply:", raw.parse().choices[0].message.content)

El envoltorio with_raw_response da acceso a los encabezados mientras parse() devuelve el objeto de respuesta habitual. La configuración de Python en sí está cubierta en cómo instalar un cliente LLM en Python si falla la importación.

Comprueba tu saldo sin una finalización

Para leer el saldo sin generar texto, llama a uno de los endpoints de saldo. Hay uno al estilo OpenAI y uno corto:

Copycurl https://api.getaiapikey.com/v1/balance \
  -H "Authorization: Bearer $API_KEY"

curl https://api.getaiapikey.com/v1/dashboard/billing/credit_grants \
  -H "Authorization: Bearer $API_KEY"

Las herramientas que ya esperan el formato de créditos de OpenAI pueden usar la segunda ruta sin cambios. Agrega una llamada como esta a un script de monitoreo y obtienes una advertencia antes de que un bot de producción se quede sin créditos. Las recargas comienzan en $20 y el crédito no caduca, por lo que no hay penalización por mantener una reserva cómoda. Los montos y bonificaciones están en la página de precios.

Convierte la prueba en una verificación de estado

Una vez que la clave funciona, mantén la prueba. Un pequeño script que se ejecuta en un horario te avisa sobre un despliegue defectuoso, un secreto expirado o un saldo bajo antes de que tus usuarios lo noten. Aquí tienes una versión en Node que usa fetch integrado (Node 18 o posterior):

Copyconst base = "https://api.getaiapikey.com/v1";

async function check() {
  const res = await fetch(`${base}/chat/completions`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "uncensored",
      max_tokens: 5,
      messages: [{ role: "user", content: "Say ok." }],
    }),
  });
  const balance = Number(res.headers.get("X-Balance-USD"));
  console.log(res.status, "balance:", balance);
  if (res.status >= 400 || balance < 5) process.exitCode = 1;
}

check();

El script sale con un código distinto de cero cuando falla la llamada o el saldo cae por debajo de $5, por lo que un trabajo cron o un paso de CI pueden alertarte. Elige el umbral desde tu propia tasa de consumo: a $2 al día, $5 te da poco más de dos días de advertencia.

Lo que una prueba que pasa no demuestra

Una marca verde muestra que la autenticación, el enrutamiento y el modelo funcionan en ese momento, con baja carga. No muestra cómo se comporta tu aplicación con 20 usuarios a la vez. Para eso, recuerda los límites: una clave completa ejecuta 8 peticiones al mismo tiempo, y las peticiones en streaming mantienen su posición hasta que termina el streaming. Prueba tu propio código con un límite en las peticiones simultáneas antes del lanzamiento.

Lectura de fallos

Lo que ves	Motivo más probable	Qué hacer
Error de autenticación, a menudo 401	Clave incorrecta, espacio en blanco extra, sin prefijo Bearer	Vuelve a copiar la clave, verifica la cadena del encabezado
404 o HTML en lugar de JSON	URL base incorrecta	Usa exactamente https://api.getaiapikey.com/v1
Modelo no encontrado	ID de modelo diferente en la petición	Establece model a uncensored
429 con rate_limited o concurrency	Demasiadas peticiones por minuto o a la vez	Espera, luego reintenta con un retraso
429 con Retry-After: 5	Sobrecarga temporal	Espera 5 segundos y reintenta
Error de conexión o de tiempo de espera	Red, proxy o firewall	Prueba desde otra red, verifica las variables del proxy

Las peticiones superiores a 8 MB se rechazan, así que si solo fallan las llamadas grandes, verifica el tamaño del cuerpo. La documentación enumera todos los códigos de error y encabezados.

Buenas prácticas para manejar una clave

• Mantén la clave en una variable de entorno o tienda de secretos, nunca en código del lado del cliente, un repositorio público o una captura de pantalla.
• Usa una clave por aplicación donde puedas, para que una filtración sea fácil de rastrear y reemplazar.
• Si una clave podría haberse filtrado, reemplázala, luego mira el saldo para gastos inesperados.
• No compartas una clave de prueba entre varios programas: con 2 peticiones simultáneas alcanzará los límites rápidamente.

Si solo quieres ver si existe una opción gratuita antes de que te registres, el artículo sobre una clave de API LLM gratuita explica qué está disponible. De lo contrario, las tres verificaciones anteriores son todas las pruebas que necesita una clave.

Más guías

• Precios de clave de API de IA: lo que realmente cuesta una clave
• Lista de Verificación de API de IA