¿Tienes un problema? Empieza aquí
Primero localiza el destino según el síntoma y luego despliega la tabla de problemas frecuentes para revisar. No repetimos contenido, solo te dirigimos a la página autoritativa.
Códigos de error completos, estructura de respuesta y estrategia de reintento —— 401 / 402 / 404 / 429 / 5xx de un vistazo.
Registro, pérdida de la API Key, diagnóstico de Key inválida, y problemas frecuentes con modelos y llamadas en streaming.
Cuota gratuita, planes de suscripción, reglas de cobro de 鹿贝, y qué hacer cuando se agota la cuota.
Integración y diagnóstico de clientes de terceros como Cherry Studio / Lobe Chat / OpenCat.
Plataforma, MemX, Lucrum y demás productos tienen su propia FAQ; consulta primero la página de preguntas frecuentes de la documentación del producto correspondiente.
Diagnóstico por mensaje de error
Despliega el error que encontraste y sigue la lista de comprobación. Para los códigos de error detallados, consulta Manejo de errores.
Devuelve 401 Unauthorized / invalid_api_key
{ "error": { "code": "invalid_api_key", "type": "authentication_error" } }authentication_error indica que la Key es inválida o falta. Revisa punto por punto:
- La Key está completa, empieza por
sk-, sin espacios ni saltos de línea de más (cópiala de nuevo) - El formato del encabezado de la petición es
Authorization: Bearer sk-xxxx(hay un espacio después deBearer) - El estado de la Key es «habilitada» (consola → gestión de tokens)
- El nombre de la variable de entorno está bien escrito y ya se ha cargado
No reintentes un 401; corrige primero la Key y vuelve a enviar. Más detalles en Autenticación y Preguntas frecuentes: cómo diagnosticar una Key inválida.
Devuelve "no available server" / model_not_found (HTTP 404)
{ "error": { "code": "model_not_found", "message": "模型 xxx 无可用渠道", "type": "new_api_error" } }- Verifica la ortografía del nombre del
model(distingue mayúsculas y minúsculas) - Confirma que esta Key tiene permiso para acceder a este modelo
- Es posible que este modelo no tenga ningún canal disponible por ahora
- Si acabas de crear la Key, espera unos 10 segundos y vuelve a intentarlo
La lista de modelos disponibles está en Modelos compatibles.
Devuelve 429 Too Many Requests / rate_limit_exceeded
{ "error": { "code": "rate_limit_exceeded", "type": "rate_limit_error" } }Se ha superado el límite de velocidad. Cómo proceder:
- Reduce la frecuencia de las peticiones y reintenta con retroceso exponencial de
2 ** attemptsegundos - Free permite 60 RPM por defecto; sube a Pro / Team para aumentar el límite
- Si tras pagar sigue activándose con frecuencia, contacta con support@lurus.cn
Un ejemplo de código de reintento está en Manejo de errores · Buenas prácticas.
Devuelve 402 / insufficient_quota (cuota / saldo insuficiente)
{ "error": { "code": "insufficient_quota", "type": "billing_error" } }- Comprueba primero si has agotado la cuota gratuita del día (el plan Free permite 100 veces/día)
- Consulta el saldo de 鹿贝: identity.lurus.cn/wallet
- Recarga por autoservicio o sube de plan; las reglas están en Información de facturación
context_length_exceeded (contexto excedido)
{ "error": { "code": "context_length_exceeded", "type": "invalid_request_error" } }Como deepseek-chat con 64K o gemini-3-pro-preview con 1M, cuando se supera el tope del modelo:
- Reduce la entrada, recorta los mensajes del historial
- Usa una ventana deslizante (conserva el system + las últimas N rondas)
- Cambia a un modelo con contexto más largo
Petición agotada / sin respuesta durante mucho tiempo
- Comprueba la conectividad de red:
curl https://hub.lurus.cn/v1/models - Reduce
max_tokens - Que los modelos de razonamiento (
deepseek-reasoner) tarden en pensar es normal - El tiempo de espera por defecto del SDK es de unos 60 segundos; puedes aumentar
timeout - Un tiempo de espera persistente puede deberse a un fallo upstream; prueba con otro modelo
¿No lo encontraste? Contacta con support@lurus.cn
X-Request-ID), la hora en que ocurrió y los pasos para reproducirlo, para localizarlo rápidamente.