Guía del Usuario

FAQ

Soluciones a errores comunes y problemas de configuración de la API de LMU AI — 401 / 403 / 429 / 500, facturación de tokens, cambio de modelos y solución de problemas de Claude Code / Codex CLI.

Problema 1: Stream desconectado / timeout

Mensaje de error:

stream disconnected before completion: error sending request for url
(https://api.lmuai.com/responses)

Causa: una desconexión de stream clásica, normalmente por:

  • una red local inestable (cambios frecuentes entre Wi-Fi / datos móviles, señal débil, pérdida de paquetes)
  • una VPN / proxy / proxy del sistema está activo: el proxy rota la IP de salida y rompe la conexión

Solución:

  1. Desactiva cualquier VPN / proxy / proxy del sistema y vuelve a intentarlo — LMU AI es una conexión directa nacional y no necesita VPN
  2. Verifica que tu red local sea estable; cámbiate a una red más confiable si es necesario

No se necesita VPN — el acceso directo dentro de China es el más rápido

El gateway de LMU AI está alojado dentro de China continental, así que puede llamarse directamente desde una red nacional sin necesidad de VPN, proxy ni ningún truco. Una conexión directa da los resultados más rápidos y estables; por el contrario, una VPN o proxy que rota la IP de salida tiende a causar desconexiones de stream.


Problema 2: Error de reintento 429

Mensaje de error:

exceeded retry limit, last status: 429 Too Many Requests

Causa: tu cuota diaria se agotó.

Solución:

  1. Abre Mi Suscripción y confirma si la cuota diaria está agotada
  2. Si necesitas más, compra un plan de un nivel diferente, luego cámbiate al grupo del nuevo plan en Claves API dentro de la consola

Renovación vs. agregar cuota

  • No compres el mismo plan — el mismo plan se renueva, no agrega cuota
  • Para agregar cuota, compra un plan diferente (por ejemplo, cambia de un pase de un día a un pase de un mes)

Problema 3: 401 Incorrect API key

Mensaje de error:

unexpected status 401 Unauthorized: Incorrect API key provided

Causa: la solicitud todavía se envió al endpoint oficial de OpenAI en lugar de nuestro relay.

Solución:

  1. Confirma que tanto config.toml como auth.json se crearon o reemplazaron correctamente
  2. Reinicia el IDE (VS Code / Cursor, etc.) para recargar los archivos de configuración
  3. Si antes iniciaste sesión con una cuenta oficial o de otro proveedor, cierra sesión primero, luego vuelve a configurar

Qué hacer cuando encuentras un error

Toma una captura de pantalla del error y tradúcelo — eso normalmente identifica la causa rápidamente.


Problema 4: Scripts deshabilitados (Windows)

Mensaje de error:

codex: cannot be loaded because running scripts is disabled on this system.

Solución: ejecuta lo siguiente en la terminal, luego abre una nueva terminal:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Problema 5: Node.js no encontrado (Windows)

Mensaje de error: CODEX is not recognized as a cmdlet, o similar

Causa: Node.js no está instalado o su PATH está roto.

Solución: reinstala Node.js 20+, luego abre una nueva terminal.


Problema 6: 503 No available accounts (las variables de entorno anulan la clave)

Mensaje de error:

Error code: 503 - {'error': {'message': 'No available accounts: no available accounts', 'type': 'api_error'}}

Causa: tu ~/.zshrc (o ~/.bashrc) establece ANTHROPIC_AUTH_TOKEN / ANTHROPIC_BASE_URL / ANTHROPIC_MODEL. Una vez que el shell arranca, estas variables surten efecto globalmente y anulan la clave API configurada en tu IDE (Cursor, VS Code, etc.), así que la solicitud usa la clave incorrecta.

Solución (elige una):

Opción A: elimina las variables de .zshrc

Abre ~/.zshrc y elimina estas líneas:

export ANTHROPIC_AUTH_TOKEN="..."
export ANTHROPIC_BASE_URL="..."
export ANTHROPIC_MODEL="..."

Luego ejecuta source ~/.zshrc para aplicar, y reinicia el IDE.

Opción B: mueve las variables a un archivo separado, cargado solo para el CLI de Claude Code

  1. Crea ~/.claude_env con las tres líneas:
export ANTHROPIC_AUTH_TOKEN="sk-your-lmu-ai-api-key"
export ANTHROPIC_BASE_URL="https://api.lmuai.com"
export ANTHROPIC_MODEL="the-model-you-use"
  1. Elimina esas tres líneas de ~/.zshrc.

  2. Cárgalas manualmente al iniciar Claude Code:

source ~/.claude_env && claude

De esta forma el IDE usa la clave de su archivo de configuración y el CLI de Claude Code usa las variables de entorno, sin interferir entre sí.


Problema 7: 400 Invalid signature in thinking block (cambiar de modelos entre grupos)

Mensaje de error:

upstream error: 400 messages.<index>.content.<index>:
Invalid `signature` in `thinking` block

Causa: cuando el Extended Thinking de Claude genera un bloque thinking, adjunta una firma cifrada que está estrechamente vinculada a la cuenta upstream específica que lo produjo. Si cambias de modelos entre grupos dentro de una misma conversación (por ejemplo, de claude-sonnet-5 en un grupo "Claude-Pro directo" a claude-fable-5 en un grupo "Claude-MAX multiplicador alto"), el cliente envía el historial previo (incluido el bloque de pensamiento firmado) a la cuenta upstream del nuevo grupo. Diferentes grupos usan diferentes upstreams y no pueden verificar una firma emitida por otro, así que devuelve 400.

Disparadores típicos:

  • El cliente admite cambiar de modelos a mitad de conversación y lleva todo el historial previo
  • Los grupos antes y después del cambio provienen de diferentes cuentas upstream (por ejemplo, "grupo directo" ↔ "grupo relay / MAX multiplicador alto")

Solución (cualquiera):

  1. Inicia una nueva conversación al cambiar de grupo — no llevar historial antiguo es la solución más simple y confiable.
  2. Mantén un solo grupo por conversación — si necesitas colaboración multimodelo, cambia dentro del mismo grupo (mismo upstream).
  3. Elimina los bloques de pensamiento del historial — si el cliente admite editar el historial, elimina los bloques thinking antes de cambiar de grupo.

¿Por qué reintentar no ayuda?

Este es un error de cliente 4xx irrecuperable causado por una firma inválida. Una vez que el gateway lo detecta, pasa el 400 directamente de vuelta al cliente y no reintenta automáticamente en otra cuenta — porque cualquier upstream no coincidente fallaría de la misma forma.


Problema 8: 400 Unknown parameter: 'tools[0].n' (tools enviados a un endpoint de imágenes)

Mensaje de error:

400 - {'error': {'code': 'unknown_parameter', 'message': "Unknown parameter: 'tools[0].n'.", 'param': 'tools[0].n', 'type': 'invalid_request_error'}}

Endpoints afectados: /v1/images/generations, /v1/images/edits (generación / edición de imágenes).

Causa: el cliente puso un arreglo tools en el cuerpo de la solicitud de imagen, con un campo n dentro de tools[0]. Los endpoints de imágenes de OpenAI no aceptan tools (las llamadas a herramientas pertenecen a los endpoints de Chat / Responses; los endpoints de imágenes no tienen tal concepto), así que el upstream lo rechaza con 400.

Esto normalmente proviene de un cliente / wrapper de SDK con bugs que pone el "número de imágenes n" en el lugar equivocado — anidado dentro de tools[0].n, o copiado de una plantilla de solicitud de Chat.

Solución:

  1. Elimina el campo tools del cuerpo de la solicitudgenerations / edits de imágenes no admiten llamadas a herramientas; elimina el campo por completo.
  2. Para generar varias imágenes, pon el número en el n de nivel superior — solo /v1/images/generations admite n (varias por llamada); /v1/images/edits no, así que elimina n ahí.
  3. Verifica la versión del SDK del cliente — si un wrapper construye los parámetros automáticamente, actualízalo o reemplázalo para que no aplique una plantilla de Chat a los endpoints de imágenes.

¿Por qué cambiar de cuenta / reintentar no ayuda?

Este es un error de cliente 4xx causado por un cuerpo de solicitud inválido, no relacionado con la cuenta o grupo upstream — el gateway pasa la solicitud tal cual, y cualquier cuenta devuelve el mismo 400. Debes corregir los parámetros de la solicitud que envía el cliente.


Problema 9: ¿Necesito una VPN?

No. El gateway de LMU AI está alojado dentro de China continental, y api.lmuai.com puede llamarse directamente desde una red nacional sin VPN, proxy ni ningún truco.

Por el contrario, una VPN o proxy que rota la IP de salida tiende a causar desconexiones de stream (ver Problema 1). Una conexión directa nacional da los resultados más rápidos y estables.


Problema 10: 401 API_KEY_REQUIRED (Codex no envía clave)

Mensaje de error:

unexpected status 401 Unauthorized: {"code":"API_KEY_REQUIRED","message":"API key is required in Authorization header (Bearer scheme), x-api-key header, or x-goog-api-key header"}, url: https://api.lmuai.com/responses, request id: ...

Causa: un bug de Codex — cuando un proveedor de modelo personalizado usa wire_api = "responses", la solicitud que Codex envía no lleva ninguna clave API (no se envía ninguna de Authorization, x-api-key, x-goog-api-key), así que el gateway no encuentra ninguna clave y devuelve 401 API_KEY_REQUIRED.

Nota que esto es diferente del Incorrect API key provided del Problema 3: ese envía una clave que es incorrecta (normalmente porque la solicitud fue al endpoint oficial de OpenAI en lugar del relay de LMU AI), mientras que este no envía ninguna clave en absoluto.

Solución: abre ~/.codex/config.toml, encuentra la sección de tu proveedor de modelo [model_providers.<ID>] (normalmente [model_providers.codex] si seguiste la guía de este sitio), y agrega requires_openai_auth = true dentro de ella:

[model_providers.codex]
name = "codex"
base_url = "https://api.lmuai.com"
wire_api = "responses"
requires_openai_auth = true

Guarda, reabre la terminal y reinicia Codex.

Los usuarios que siguieron la guía de este sitio no se ven afectados

Cada guía de Codex en este sitio (Mac / Windows / Server / Codex App) ya incluye requires_openai_auth = true en su ejemplo de config.toml. Si encuentras este error, tu configuración probablemente se copió de una guía más antigua u otra fuente que omitió esta línea — agrégala como se muestra arriba.


¿Sigues atascado?

Si un entorno especial todavía te bloquea durante la instalación o configuración, contacta al soporte:

  • Agrega al soporte en WeChat
  • Contacta al soporte en Xianyu (闲鱼)

Horario de asistencia remota: después de las 2 p. m. (las mañanas se dedican a resolver configuraciones de entorno complejas de forma remota).

Si necesitas ayuda remota, descarga primero NetEase UU Remote y envíalo al soporte; la guía técnica y la asistencia remota se realizan por la tarde después de las 2 p. m.

Última actualización:

En esta página