ES ▾
Obtener clave de API

kimiapikey.comGuía

Clave de API de Kimi no funciona: causas, soluciones y alternativa

Si tu error de clave de API de kimi no funciona aparece como 401, 404 o 429, la causa es casi siempre una de cinco cosas: la URL base incorrecta, una clave que no coincide, sin saldo, un límite de peticiones o un nombre de modelo que el endpoint no conoce. Recórrelas en este orden.

Actualizado

Una clave atascada en una cerradura mientras un camino de luz verde lleva a una segunda cerradura abierta, simbolizando un endpoint de API alternativo
Ilustración isométrica de un editor de código conectado con un cable brillante a un servidor de API

Puntos clave

  • Una clave solo funciona con el proveedor que la emitió, por lo que la URL base y la clave deben provenir del mismo panel.
  • 401 significa que se rechazó la clave, 404 suele significar una ruta incorrecta, 429 significa que alcanzaste un límite o el servicio está ocupado.
  • Imprime el código de estado y el cuerpo de la respuesta antes de cambiar cualquier otra cosa.
  • Mantén un segundo endpoint compatible con OpenAI configurado para que una sola interrupción no detenga tu aplicación.

Lee el código de estado primero

Antes de regenerar cualquier cosa, mira lo que dijo realmente el servidor. La mayoría de los clientes estilo OpenAI ocultan el cuerpo detrás de una excepción genérica. Imprime tanto el código de estado como el cuerpo.

curl -i https://api.kimiapikey.com/v1/models \
  -H "Authorization: Bearer $YOUR_KEY"

La primera línea de la respuesta te dice dónde buscar:

Código de estadoSignificado habitualEmpieza con
401Clave rechazadaCopia de clave; clave y URL base de proveedores distintos
404Ruta o modelo no encontradoFalta /v1, ruta duplicada, ID de modelo incorrecto
400Cuerpo de petición inválidoNombres de parámetros, formato de mensaje, tamaño del cuerpo
429Límite alcanzado o servicio ocupadoTasa de petición, llamadas paralelas, temporización de reintento
5xxProblema del lado del servidorReintenta con retroceso, luego cambia a un punto de respaldo

Si no obtienes ninguna respuesta HTTP en absoluto (un tiempo de espera o un error de DNS), el problema es la red o el nombre de host que escribiste, no la clave.

La URL base y la clave deben pertenecer juntas

Esta es la razón más común por la que una clave nueva falla. Las claves se emiten por proveedor. Una clave de un panel es simplemente desconocida para los servidores de otro proveedor, por lo que devuelve 401 aunque la clave sea perfectamente válida donde proviene.

Verifica estos puntos:

  • La clave y la URL base provienen de la misma página de cuenta. Si copiaste la clave de un proveedor y dejaste una URL base antigua en tu configuración, la petición se dirige al lugar incorrecto.
  • Las variables de entorno no están ocultando tu código. El SDK de OpenAI lee OPENAI_API_KEY y OPENAI_BASE_URL cuando no los pasas explícitamente, por lo que una variable de shell obsoleta puede anular lo que escribiste en el archivo.
  • No hay espacio en blanco ni salto de línea al final de la clave. Un salto de línea final por copiar y pegar es una causa clásica de 401.
  • El encabezado es exactamente Authorization: Bearer <key>. Algunas herramientas esperan la clave en un encabezado diferente y necesitan que el modo compatible con OpenAI esté activado.

Los editores y las interfaces de chat añaden otra trampa. Muchos de ellos mantienen un campo separado para la "URL base de OpenAI" y un interruptor separado que lo habilita. Si el interruptor está apagado, la aplicación sigue llamando silenciosamente al host predeterminado con tu clave nueva, y obtienes un 401 que parece una clave incorrecta. Guarda la configuración, reinicia la aplicación si la almacena en caché y envía un mensaje de prueba corto antes de probar algo más complejo.

La URL base debe terminar en /v1, no en el host ni en /v1/chat/completions. El SDK adjunta el resto. Una URL que ya incluye la ruta completa termina siendo una ruta duplicada y un 404.

Acceso regional, proxies y redes corporativas

A veces la clave está bien y la petición nunca llega al servidor correcto. La disponibilidad del proveedor puede depender de desde dónde te conectas, y una VPN, un proxy corporativo o una regla de firewall pueden bloquear o reescribir el tráfico. Consulta la documentación o la página de estado del proveedor para sus regiones admitidas, y no asumas que las reglas son las mismas que para otro servicio.

Una prueba rápida de aislamiento: ejecuta el mismo comando curl desde una red diferente, como un punto de acceso de teléfono. Si funciona allí, la clave es buena y tu red es la causa. Si el proxy establece HTTPS_PROXY, verifica que tu biblioteca HTTP realmente lo respete; algunas herramientas lo ignoran y fallan con un error de conexión.

Saldo, cuota y cómo se ve un límite de peticiones

Una clave puede ser válida y aún así rechazar peticiones porque la cuenta no tiene crédito restante o se ha agotado una cuota. Verifica el panel antes de depurar código. Si nunca has recargado, recuerda que los permisos gratuitos suelen ser pequeños y de corta duración.

Un 429 es otro asunto. Significa que el servidor te está frenando, no que la clave sea mala. En el endpoint descrito en este sitio, una clave completa permite 8 peticiones concurrentes y 300 peticiones por minuto, y una clave de prueba permite 2 concurrentes y 60 por minuto. Cuando los excedes, la API devuelve HTTP 429 con el código de error rate_limited (demasiadas por minuto) o concurrency (demasiadas a la vez). La sobrecarga temporal también devuelve 429, con un encabezado Retry-After: 5.

Dos hábitos corrigen la mayoría de estos. Honra Retry-After cuando esté presente, y limita tus peticiones simultáneas al límite de concurrencia. Una petición en streaming mantiene su espacio hasta que termina el streaming, por lo que un flujo estancado cuenta contra ti más tiempo de lo que esperas.

Nombre del modelo, parámetros y tamaño del cuerpo

Un 404 o un 400 con una clave válida generalmente apunta a la propia petición. Tres cosas a verificar:

  1. ID del modelo. Cada proveedor tiene sus propios nombres de modelos. Pregunta al endpoint qué sirve con GET /v1/models y copia el ID de la respuesta. En este sitio, el ID es uncensored.
  2. Parámetros. Nombres como max_tokens, temperature y response_format son estándar, pero un proveedor puede aceptar solo un subconjunto. Elimina los campos opcionales hasta que la petición pase, luego agrégalos de uno en uno.
  3. Tamaño. Los prompts muy grandes pueden fallar por límites del cuerpo antes de que el modelo los vea. Aquí, el cuerpo máximo es de 8 MB y la ventana de contexto es de 100.000 tokens para prompt y completado juntos.

El streaming es otro lugar donde una clave que funciona parece rota. Si una petición tiene éxito sin stream: true y falla con ella, la causa suele ser un proxy que almacena en caché o corta los eventos enviados por el servidor, no el endpoint. Desactiva el streaming para confirmar, luego mira la configuración del proxy.

Si solo cambiaste el nombre del modelo y la llamada falló, vuelve a poner el nombre antiguo para confirmar que el resto de tu configuración está bien.

Mantén un punto de respaldo endpoint listo

Incluso un proveedor saludable tiene horas malas. Si tu producto depende de una clave, un solo fallo se convierte en tu interrupción. Debido a que el formato de petición de OpenAI es compartido, puedes mantener un segundo endpoint configurado y cambiar con un par de líneas.

El endpoint en este sitio es compatible con OpenAI, por lo que se integra como un segundo proveedor. Es un modelo de pesos abiertos alojado de forma independiente, no el servicio oficial de Moonshot, y responderá de manera diferente que un modelo Kimi, así que prueba tus prompts antes de confiar en él. Aquí hay un pequeño envoltorio que intenta el principal primero y falla en errores:

import os
from openai import OpenAI

primary = OpenAI(base_url=os.environ["PRIMARY_BASE_URL"],
                 api_key=os.environ["PRIMARY_KEY"])
fallback = OpenAI(base_url="https://api.kimiapikey.com/v1",
                  api_key=os.environ["FALLBACK_KEY"])

def ask(messages):
    try:
        r = primary.chat.completions.create(
            model=os.environ["PRIMARY_MODEL"], messages=messages, timeout=30)
    except Exception as e:
        print("primary failed:", e)
        r = fallback.chat.completions.create(
            model="uncensored", messages=messages, timeout=60)
    return r.choices[0].message.content

print(ask([{"role": "user", "content": "Say hi in five words."}]))

La facturación es pago por uso: $0,15 por cada 1M de tokens de entrada y $0,50 por cada 1M de tokens de salida desde crédito prepago que no caduca. Las peticiones fallidas o rechazadas no se cobran, por lo que un respaldo que rara vez se ejecuta cuesta casi nada mantener. Las recargas comienzan en $20; consulta precios para los niveles de bonificación.

Prueba el respaldo en dos minutos

Los nuevos usuarios pueden reclamar $0,50 de crédito de prueba con un solo clic en la página de clave de API después de iniciar sesión. No necesita tarjeta y es válido por 7 días, lo cual es suficiente para ejecutar tus prompts reales a través del endpoint una vez. Luego ejecuta la prueba de humo a continuación.

curl https://api.kimiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $FALLBACK_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'

Verifica el encabezado de respuesta X-Balance-USD para ver tu crédito restante. La referencia completa de la petición está en la documentación. Si estás conectando esto a un editor, la guía existente sobre uso de una clave de API estilo Kimi en Cursor muestra dónde vive el campo de URL base, y la visión general de la clave de API de Kimi explica cómo este endpoint se relaciona con el modelo que estabas usando.

Preguntas frecuentes

¿Es el modelo el mismo que el Kimi oficial de Moonshot?
No, alojamos un modelo de pesos abiertos que está ajustado para ser sin censura. No es GPT, Claude, Gemini, Grok, DeepSeek ni ningún otro modelo de proveedor. Es un modelo distinto ejecutado en nuestros propios servidores.

¿Entrenan con mis datos?
No. Tus prompts y completados no se utilizan para el entrenamiento. Valoramos la privacidad y la transparencia, por lo que tus datos siguen siendo tuyos.

¿Cuáles son los límites de peticiones?
Estás limitado a 300 peticiones por minuto por clave. El tamaño máximo del cuerpo de la petición es de 8 MB. Estos límites están diseñados para garantizar un rendimiento estable para todos los usuarios.

¿Cuál es la política de contenido?
El modelo es sin censura respecto a temas adultos, controversiales y creativos. Sin embargo, bloqueamos contenido sexual que involucre menores. Este es un límite estricto que siempre se aplica, independientemente de tu nivel de suscripción.

Preguntas y respuestas

¿Por qué mi clave nueva devuelve 401 de inmediato?

Las razones más comunes son una clave enviada a la URL base de otro proveedor, un espacio o salto de línea en la clave copiada, o una variable de entorno que sobrescribe tu código. Prueba con curl para descartar que sea tu SDK.

¿Un 429 es lo mismo que una clave incorrecta?

No. Un 429 significa que has alcanzado un límite de peticiones, un límite de concurrencia o una sobrecarga temporal. La clave es válida. Espera el valor de Retry-After y reduce tus peticiones simultáneas.

¿Las peticiones fallidas cuestan dinero aquí?

No. Las peticiones fallidas o rechazadas no se cobran en este endpoint, por lo que reintentar una llamada fallida no agota tu crédito.

¿Puedo usar este endpoint como un reemplazo listo para usar para un modelo Kimi?

Habla el mismo formato de petición de OpenAI, por lo que el cambio de código es solo la URL base, una clave y el modelo uncensored. El modelo subyacente es diferente, por lo que las respuestas no coincidirán; prueba tus prompts primero.

Tu clave está a un paso de completarse

Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.

Obtener clave de APILeer la documentación