APIshop Documentation
Support Center

Troubleshooting

When the client connection fails, a request times out, or a model call throws an exception, you can start troubleshooting with this page.

Connection failed

  • - First, make sure the Base URL is correct.
  • - Recheck the Key, proxy, and DNS configuration.
  • - If necessary, switch to a different client for comparison testing.

Claude Code 400

  • - Check whether the request parameters meet the requirements of the current model.
  • - Confirm that the Key read by the client has not been truncated.

Gemini CLI Error

  • - Confirm that the environment variables read by the CLI are correct.
  • - Check whether the Base URL and model name match.

API Connect / Timeout

  • - First, check your local network and proxy settings.
  • - Confirm again that the target endpoint is reachable.
  • - Shorten the workflow when necessary and run local comparison tests.

Model not visible

  • - Refresh the model list.
  • - Check the account permissions and provider status.

503 / Service Unavailable

  • - First, check whether there are any alerts on the status page.
  • - Double-check whether it’s temporary maintenance or an upstream issue.

说明

  • - When troubleshooting, please try to record the full error message, the timestamp, and the steps to reproduce it.
  • - If the same question comes up multiple times, consider turning it into an FAQ entry.