Resolver problemas de conexión con GetAPI.ONE

Conservar primero contexto seguro

• Servicio: confirme que usa GetAPI.ONE y no una clave o dirección de otro servicio GetAPI.
• Hora y zona horaria, cliente y versión exactos, sistema operativo, ruta del endpoint, nombre exacto del modelo y nombre o grupo de la clave.
• Estado HTTP, mensaje de error visible e identificador de solicitud si existe.
• Si la consola muestra un registro correspondiente de solicitud o uso.

401, clave ausente o fallo de autenticación

1. Abra la lista de claves GetAPI.ONE y confirme que la clave prevista existe, está habilitada y no ha caducado.
2. Copie de nuevo la clave desde la lista. Quite espacios iniciales o finales y comillas introducidas por un campo de configuración.
3. Confirme que el cliente lee la variable de entorno o ubicación de configuración utilizada por el proceso actual.
4. Combine una clave GetAPI.ONE únicamente con https://www.getapi.one o el endpoint o URL base ONE documentado.
5. Reinicie el cliente tras corregir la configuración y realice un reintento limitado.

• Guía de claves API

404 o ruta de solicitud incompatible

1. Determine si el cliente espera una URL base o un endpoint completo. Codex/CCSwitch usa https://www.getapi.one/v1 como base en el procedimiento de referencia.
2. Para llamadas directas, compare método y ruta exactos con el endpoint declarado del modelo seleccionado.
3. Compruebe si falta o se duplica /v1 y si el cliente añadió automáticamente /responses o /chat/completions.
4. No fuerce operaciones Anthropic, Gemini, de imagen o vídeo por una ruta OpenAI Chat o Responses.

• Endpoints API declarados
• Etiquetas de endpoints de modelos

Modelo no encontrado o acceso denegado

1. Copie el nombre exacto del catálogo actual; muchos clientes distinguen mayúsculas y puntuación.
2. Confirme que el modelo incluye explícitamente el endpoint que envía su cliente.
3. Confirme que el grupo de la clave ofrece el modelo y que las restricciones avanzadas no lo excluyen.
4. Actualice los datos del catálogo en lugar de depender de una captura o lista antigua; la disponibilidad puede cambiar.

Cuota, saldo, caducidad o límite de frecuencia

1. Compruebe primero la caducidad y cuota restante de la clave.
2. Compruebe por separado el saldo o la aplicabilidad del paquete.
3. Abra Precios en vivo para el modelo, endpoint, unidad y grupo exactos justo antes de reintentar.
4. Ante límites de frecuencia, reduzca la concurrencia y siga las indicaciones de reintento de la respuesta. Nunca repita en un bucle ilimitado.

• Guía de facturación y uso
• Precios en vivo

La configuración del cliente no se aplicó

• Codex CLI: verifique el config.toml de usuario cargado por la instalación actual, model_provider, la escritura de env_key, base_url, wire_api y model.
• Procedimiento CCSwitch: verifique que el destino y proveedor correctos estén habilitados, los valores guardados y el destino completamente reiniciado.
• Si un destino de escritorio no expone o acepta la configuración, no presuponga compatibilidad; use Codex CLI o un cliente API directo.

• Guía de Codex CLI
• Límite de compatibilidad de CCSwitch

Tiempo de espera agotado, fallo de red o del proveedor

1. Confirme el acceso HTTPS general a www.getapi.one sin considerar una respuesta normal de página como prueba de una llamada al modelo.
2. Busque en la consola una solicitud fallida correspondiente y conserve identificador, hora, endpoint y modelo.
3. Determine si la solicitud pudo procesarse antes de reintentar, especialmente en operaciones multimedia o de tareas no idempotentes.
4. Reintente solo cuando proceda, con cantidad y espera limitadas. Si persisten los fallos, escale con la lista de contexto seguro.

Escalar con pruebas reproducibles

Indique servicio (GetAPI.ONE), paso exacto, cliente y versión, hora y zona horaria, modelo, endpoint, nombre o grupo de clave oculto, estado HTTP, error, identificador y existencia de registro en consola. Describa una reproducción mínima y las comprobaciones ya realizadas.

• Canales de asistencia