Docs › Setup guides

Use SteadyRouter with Dify

In Dify, add SteadyRouter models through the OpenAI-API-compatible model provider. For Claude models, you can use the Anthropic provider instead, so Claude features such as prompt caching and extended thinking work the way they do with Anthropic's API. Both use the same SteadyRouter key.

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. Find the model names you want on Model Square, for example gpt-5-mini.

Add models with OpenAI-API-compatible

1. In Dify, open Settings → Model Provider. If OpenAI-API-compatible isn't listed, install it from the Dify Marketplace.
2. On the OpenAI-API-compatible card, add a model. Dify adds models one at a time:

   Field	Value
   Model type	LLM
   Model Name	the name from Model Square, for example gpt-5-mini
   Model display name	optional
   API Key	your SteadyRouter key
   API Base URL	https://api.steadyrouter.com/v1
   Completion mode	Chat
   Model context size	the model's context window, from the model developer's docs
   Upper bound for max tokens	the model's maximum output
   Function Call Type	Tool Call, if the model supports tools and you use agents or tool nodes
   Vision Support	Support, if the model accepts images

3. Save. Repeat for each model you want.

Claude models with the Anthropic provider

1. In Settings → Model Provider, install the Anthropic provider if it isn't listed.
2. API Key: your SteadyRouter key.
3. API URL:
   URLCopy

   https://api.steadyrouter.com

4. Save, then pick a Claude model such as claude-haiku-5-5 in your app. To use one that isn't listed, such as claude-sonnet-5-5, add it on the Anthropic card with Add Model, using its model name.

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 request asks for (the Max Tokens setting of the model in your app). 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, and keep Max Tokens in your app modest (8192 or less). 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

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

More: API docs · Model Square