SoloEnt Third-Party API Troubleshooting Guide
event
What's the worst thing that can happen with an AI writing tool? Errors halfway through, connection failures, no response at all.
If you're connecting to SoloEnt using a third-party API, you may run into a few hiccups. Here's a rundown of the most common issues and how to fix them — so when something goes wrong, you can zero in on the solution fast.
Invalid API Key
You probably copied the key with an extra space, or the key has expired.
Fix: Copy the key again and make sure there are no leading or trailing spaces. If that doesn't work, go to your dashboard and generate a new key.
Connection Failed
The network is unreachable, or the Base URL was entered incorrectly.
Fix: First, double-check the Base URL — confirm the address is correct. If you're unsure, reach out to the third-party provider's support team. Then check your network connection. If you're using a VPN or proxy, try disabling it and reconnecting.
Rate Limit Exceeded
Too many requests sent in a short period — you've been throttled.
Fix: Wait a few minutes and try again. If this happens frequently, consider switching to a more reliable third-party service, or use SoloEnt's official API instead.
Model Unavailable
You've selected a model that doesn't exist, or your account doesn't have permission to use it.
Fix: Double-check the model ID and confirm that the model is included in your current plan or service tier.
Missing Required Fields
Your configuration is incomplete.
Fix: For OpenAI-compatible APIs, three things are required — no exceptions: Base URL, API Key, and Model ID.
Agent Not Responding
Everything looks configured correctly, but nothing happens.
Fix: Check your key and network first, then try switching to a different model. This could also indicate that the third-party service you're using is unstable or that the model quality is insufficient. Consider switching to a more reliable third-party provider, or use SoloEnt's official API.
Connection Error
Your network seems fine, but the connection still fails.
Fix: Check whether the service provider is experiencing any outages. If the issue persists, consider switching to a more stable third-party service, or use SoloEnt's official API.
The short version
Most problems come down to three things: wrong key, network issue, or incomplete configuration. Troubleshoot in that order and you'll resolve over 80% of issues.
If you've tried everything and it's still not working, take a screenshot and post it in the group or contact technical support — include any error messages so the team can help you faster.