OneMux/Documentación/Preguntas frecuentes

Preguntas frecuentes

¿Has encontrado un error al realizar una llamada a la API? Localiza rápidamente el problema según el código de estado. Esta página enumera los códigos de error más comunes y sus soluciones; la mayoría de los problemas se pueden resolver por cuenta propia en 1 minuto.

Diagnóstico rápido

Cuando aparezca un error en el código, busca primero el código de estado HTTP (como 401 o 429) y consulta la solución correspondiente:

Código de estadoCausaSolución
401API Key no válidaComprueba el formato de la clave (sk-xxx) y su validez
402Saldo insuficienteRecarga saldo en la consola
404ID del modelo incorrectoCopia el ID correcto desde la página del modelo
429Solicitudes demasiado frecuentesReduce la frecuencia y vuelve a intentarlo después de 10 segundos
500Fallo del servicio upstreamVuelve a intentarlo más tarde o cambia de modelo

401 - API Key no válida

Causas más comunes:

  • Se añadieron espacios al copiarla
  • El formato es incorrecto (no comienza por sk-)
  • La clave se eliminó

Solución rápida:

# ✅ 正确格式
api_key = "sk-1234567890abcdef"

# ❌ 常见错误
api_key = " sk-1234567890abcdef "  # 前后有空格
api_key = "1234567890abcdef"       # 缺少 sk- 前缀

Ve a la consola para volver a copiar la clave o crear una nueva.

402 - Saldo insuficiente

El saldo de la cuenta no es suficiente para pagar esta solicitud.

Ve al centro de facturación para recargar saldo.

Nota: Las solicitudes con contextos largos (como Gemini al procesar 1 millón de tokens) reservan por adelantado el coste máximo posible. Asegúrate de tener saldo suficiente.

404 - El modelo no existe

Causas comunes:

  • El ID del modelo está mal escrito
  • Se usa un nombre de modelo antiguo (por ejemplo, gpt-4o ha sido sustituido por gpt-6.1-sol)
  • La ruta de Base URL es incorrecta

Solución:

Obtener el ID correcto del modelo

  1. 1

    Visitar la página de modelos

    Abre https://onemux.net/models

  2. 2

    Buscar el modelo que necesitas

    Busca o explora hasta encontrar el modelo deseado

  3. 3

    Copiar el ID del modelo

    Haz clic en el botón de copiar o copia manualmente el ID completo

Confirma que Base URL sea https://api.onemux.net/v1 (observa que al final incluye /v1)

429 - Solicitudes demasiado frecuentes

Se han enviado demasiadas solicitudes en poco tiempo y se ha activado el límite de frecuencia.

Solución:

  • Reduce la frecuencia de las solicitudes
  • Espera 10-30 segundos y vuelve a intentarlo
  • Añade una lógica de reintento automático (consulta la documentación sobre gestión de errores)
  • Reduce el número de tareas simultáneas

500/502/503 - Fallo del servicio

El servicio del modelo upstream no está disponible temporalmente.

Solución:

  • Espera 10-30 segundos y vuelve a intentarlo
  • Cambia a otro modelo
  • Consulta la página de estado para conocer el estado del servicio

Orden de diagnóstico cuando no estás seguro del problema

Diagnóstico paso a paso

  1. 1

    Comprobar el saldo

    Inicia sesión en la consola y confirma que el saldo sea suficiente

  2. 2

    Comprobar la API Key

    Vuelve a copiar la clave completa y asegúrate de que no contenga espacios

  3. 3

    Comprobar el ID del modelo

    Vuelve a copiarlo desde la página del modelo

  4. 4

    Comprobar Base URL

    Confirma que sea https://api.onemux.net/v1

  5. 5

    Reiniciar el software

    Guarda la configuración y reinicia el cliente