Conexión y uso

Cuando una llamada falla o se interrumpe una conversación, verifica primero tres aspectos con una solicitud mínima: autenticación, ruta del endpoint y disponibilidad del modelo.

¿No puedes conectar con la plataforma?

Comprueba:

• Si la clave de API está configurada correctamente, sin espacios ni saltos de línea adicionales.
• Si la URL base es correcta y no contiene rutas duplicadas.
• Si la ruta del endpoint corresponde al protocolo del cliente, como la ruta compatible con OpenAI para clientes OpenAI.
• Si la red local, proxy corporativo, cortafuegos, DNS o inspección HTTPS bloquean solicitudes.
• Si la clave de API ha caducado, se ha eliminado o pertenece a una cuenta restringida.

Para llamadas compatibles con OpenAI, prueba una solicitud mínima sin streaming:

curl https://api.apihop.ai/openai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      { "role": "user", "content": "Reply with OK only." }
    ],
    "stream": false
  }'

Si la solicitud mínima falla, el problema suele estar en la red, autenticación, configuración de rutas, permisos del modelo o estado de la cuenta.

¿Has elegido un modelo pero no responde o devuelve un error?

Causas habituales:

• El ID del modelo es incorrecto o no coincide con la lista de la plataforma.
• El modelo elegido no está disponible temporalmente o no está permitido para la clave de API.
• El formato de solicitud no es válido, por ejemplo, nombres de campos, anidación o tipos incorrectos.
• La cuenta tiene saldo insuficiente, el contexto o la salida son demasiado largos, o el servicio agotó el tiempo de espera.
• El cliente de terceros no gestiona correctamente el streaming o las respuestas de error.

Copia el ID exacto de la consola o lista de modelos, prueba con un cuerpo mínimo y vuelve a añadir contexto y parámetros gradualmente.

¿Qué hago si un chat da error o se desconecta?

Identifica dónde falla:

• Antes de iniciar la solicitud: comprueba autenticación, ruta, modelo y parámetros.
• Durante el streaming: comprueba el tiempo de espera del cliente, la cadena de proxies y el análisis de SSE.
• Con contexto o salida largos: comprueba el tamaño de la solicitud, límites de salida y tiempo de espera del servicio.

Tratamiento recomendado:

1. Lee los campos concretos del error.
2. Desactiva temporalmente el streaming para distinguir un fallo del modelo de un fallo al interpretar el streaming.
3. Añade reintentos con espera progresiva para 429, inestabilidad de red y algunos errores 5xx.
4. Incluye el contexto necesario en los reintentos, sin asumir que el servidor conserva el estado de la conversación.
5. Registra X-Request-ID si el problema persiste.