HopBase DocsTroubleshooting
Quickly diagnose protocol, key, model, and environment errors.
Match the error message first, then verify the provider type, Base URL, plan key, and model ID.
| Error | Cause | Resolution |
|---|---|---|
| 404 "The current platform does not support this API path" | A Claude plan key is using the OpenAI protocol, or was placed in Codex | Select an Anthropic provider for Claude and use https://api.hop-base.com without /v1 |
| 401 / invalid API key | The key is incomplete, deleted, or contains extra spaces | Copy it again from Key Management, or create a new key |
"Model ... is not supported" / model_not_found | The model is not included in the key's plan group | Call GET /v1/models with that key and use a returned ID, or switch to the matching plan key |
400 InputImageSensitiveContentDetected.PrivacyInformation / "may contain real person" | Seedance 2.0 runs real-person privacy detection on reference images passed directly in content; both public URLs and data: base64 are rejected | Upload the image with POST /v1/sd/assets, wait for Status=Active, then reference it as asset://asset-id in content. Seedance 2.5 has no asset upload route, so use a Seedance 2.0 model for real-person references |
| Insufficient balance | The USD balance is exhausted | Add funds in the console; no configuration change is required |
| "Service busy, try again later" / 502 | Temporary upstream model instability | Retry shortly; contact support if it persists for more than 10 minutes |
| "node / npm is not recognized" | Node.js is missing or not in PATH | Reinstall from nodejs.org, then close and reopen the terminal |
| PowerShell blocks script execution | Windows execution-policy restrictions | Prefer the console's one-click command, or run Set-ExecutionPolicy RemoteSigned as Administrator |
| Configuration looks correct but cannot connect | /v1 is missing or duplicated, or the URL contains whitespace | Compare the Base URL character by character: OpenAI includes /v1; Anthropic does not |
Still stuck? Contact us with the client name, model ID, approximate time, HTTP status, and a screenshot with the key hidden. Include the request ID when the response provides one.