Documentación de HopBaseSolución de problemas
Diagnostique rápidamente errores de protocolo, clave, modelo y entorno.
Primero identifique el mensaje de error y luego verifique el tipo de proveedor, la Base URL, la clave de plan y el ID del modelo.
| Error | Causa | Resolución |
|---|---|---|
| 404 "The current platform does not support this API path" | Una clave de plan Claude está usando el protocolo OpenAI, o se colocó en Codex | Seleccione un proveedor Anthropic para Claude y use https://api.hop-base.com sin /v1 |
| 401 / clave API inválida | La clave está incompleta, fue eliminada o contiene espacios adicionales | Cópiela nuevamente desde Claves API, o cree una clave nueva |
"Model ... is not supported" / model_not_found | El modelo no está incluido en el grupo de plan de la clave | Llame a GET /v1/models con esa clave y use un ID devuelto, o cambie a la clave de plan correspondiente |
400 InputImageSensitiveContentDetected.PrivacyInformation / "may contain real person" | Seedance 2.0 ejecuta detección de privacidad de personas reales en las imágenes de referencia pasadas directamente en content; tanto las URL públicas como el base64 en data: son rechazados | Suba la imagen con POST /v1/sd/assets, espere a Status=Active y luego referéncíela como asset://asset-id en content. Seedance 2.5 no tiene ruta de carga de assets, así que use un modelo Seedance 2.0 para referencias de personas reales |
| Saldo insuficiente | El saldo en USD se agotó | Añada fondos en la consola; no se requiere ningún cambio de configuración |
| "Service busy, try again later" / 502 | Inestabilidad temporal del modelo upstream | Reintente en breve; contacte a soporte si persiste por más de 10 minutos |
| "node / npm is not recognized" | Node.js no está instalado o no está en PATH | Reinstale desde nodejs.org, luego cierre y vuelva a abrir la terminal |
| PowerShell bloquea la ejecución de scripts | Restricciones de la política de ejecución de Windows | Prefiera el comando de un clic de la consola, o ejecute Set-ExecutionPolicy RemoteSigned como administrador |
| La configuración parece correcta pero no se puede conectar | Falta o está duplicado /v1, o la URL contiene espacios en blanco | Compare la Base URL carácter por carácter: OpenAI incluye /v1; Anthropic no |
¿Sigue atascado? Contáctenos con el nombre del cliente, ID del modelo, hora aproximada, estado HTTP y una captura de pantalla con la clave oculta. Incluya el request ID cuando la respuesta proporcione uno.