SteadyRouterDocs

Docs › Setup guides

Use SteadyRouter with Cherry Studio

Add SteadyRouter to Cherry Studio as a model provider. For Claude models, also add a second provider with the Anthropic endpoint, so Claude features such as prompt caching and extended thinking work the way they do with Anthropic's API.

Before you start

  1. Create a SteadyRouter account.
  2. In the console, open API Keys and copy your key. New accounts come with one called Default Key, on Lowest price (see below). To make another, click Create API Key. Keep Smart routing on: if a group fails, the request is retried in the next group within the same call. A new key starts on Auto, or on Lowest price if your balance is under US$1.
  3. Install Cherry Studio.

Add the provider

  1. In Cherry Studio, open Settings → Model Provider and click Add Provider.
  2. Provider Name: SteadyRouter.
  3. Under Endpoint settings, fill in the OpenAI field:
    URL
    https://api.steadyrouter.com

    Cherry Studio adds /v1/chat/completions itself; the field shows the full request path below it.

  4. API Key: your SteadyRouter key.
  5. Click Add.
  6. Click Sync models and add only the models you use. There are hundreds of models; the names match Model Square, for example gpt-5-mini.
  7. Click Model Check and pick a model to check the connection.

For Claude models, add a second provider the same way, named for example SteadyRouter Claude, and fill in the Anthropic field under Endpoint settings instead, with the same address, https://api.steadyrouter.com (the request path shown is /v1/messages). Each provider sends requests to one endpoint, which is why Claude gets its own provider. Then add Claude models such as claude-sonnet-5-5 to it.

Trying it on a small balance

New accounts currently start with US$0.05 of credit. Before each request, the gateway reserves balance based on the input plus the maximum output the app asks for. To make a small balance last:

  1. Use Lowest price under Smart routing on your API key. Default Key is already on it; for another key, choose it when you create the key or later by editing it.
  2. Start with a smaller model. On Lowest price, a request to claude-haiku-5-5 or gpt-5-mini costs a small fraction of the same request to larger models such as claude-sonnet-5-5, gpt-5.5 or claude-opus-5-5.

Once you've confirmed everything works, add funds, and switch the key back to Auto if you prefer.

Lowest price often puts Pool groups first: usually cheaper, sometimes less stable. In every smart routing mode, Pool and Mixed groups can be used, so for stability-critical work, turn smart routing off and list only cloud or API groups on the key. See Models and groups.

If something goes wrong

What you seeWhat to do
404 in Model CheckCheck the address in the endpoint field: https://api.steadyrouter.com.
401 Invalid tokenThe key is wrong, disabled, expired or out of its spending cap. Check it under API Keys.
403 insufficient_user_quotaYour balance can't cover the request. Top up, or follow the small-balance steps above.
503 model_not_foundThe model name is wrong, or the groups your key uses don't offer it. Check the name on Model Square.
408, 504 or 524An upstream timeout. These are not moved to another group automatically, so retry.

Every error message ends with a request id. Include it when you email support@steadyrouter.com.

More: API docs · Model Square