Setup guide

Connect SillyTavern to Toolgram

SillyTavern talks to any OpenAI-compatible endpoint. You need three values: a base URL, a key, and a model ID. This page gives you the exact ones and the settings that cause most failed connections.

Updated 22 October 2026 · Toolgram

Quick answer

In SillyTavern open API Connections, choose Chat Completion, set the source to Custom (OpenAI-compatible), enter https://toolgram.app/api/v1 as the endpoint, paste your Toolgram key, and select a model ID from toolgram.app/app/models. Add USDT credit first, because requests are paid from the balance.

Before you start

You need two things from the dashboard: a key and a positive balance. Both live at toolgram.app/app. The key is created in the API tab. The balance is funded with USDT on TON, minimum $2.

Keep the key private. Anyone with the key can spend your balance, and there is no card to reverse a charge.

Step by step

  1. Create the key. Open toolgram.app/app, add funds, then create a key in the API tab and copy it.
  2. Open API Connections. In SillyTavern, click the plug icon in the top navigation bar.
  3. Set the API type. Choose Chat Completion as the API.
  4. Set the source. Choose Custom (OpenAI-compatible).
  5. Enter the endpoint. Paste https://toolgram.app/api/v1 into Custom Endpoint. The /v1 is already part of the URL.
  6. Paste the key. Put the Toolgram key in the API key field. Remove any trailing space.
  7. Pick the model. Copy the exact ID from the models page and paste it into the model field. If the fetch button returns nothing, typing the ID works just as well.
  8. Test it. Send one short message. Then check the dashboard: the balance should drop by the cost of that request.

The three values

API:        Chat Completion
Source:     Custom (OpenAI-compatible)
Endpoint:   https://toolgram.app/api/v1
API key:    sk-...  (from the API tab)
Model:      deepseek-v4.1-flash  (any ID from /app/models)

Picking a model

For roleplay and long chats, pick a model with a large context window so the character card and recent history fit without truncation. The models page lists context size next to each ID. Price per token matters less than context here, because long sessions send the whole history on every turn.

If you are testing a setup, start with the cheapest chat model on the list, confirm the connection works, then move to the model you actually want.

Troubleshooting

401 Unauthorized

The key is wrong, revoked, or has whitespace. Create a fresh key and paste it again. A missing key produces the same error as a wrong one.

404 or model not found

The model ID does not match the catalog exactly. Copy it from the models page rather than typing it from memory. A base URL with /v1/v1 also produces confusing 404s.

Connection works, replies are empty

Check the balance first. Requests are rejected when the balance is zero even if the key is valid. Then check that the model supports the request type you are sending.

Streaming stalls

Turn streaming off once to confirm the endpoint and key. If non-streaming works, the issue is on the client side or the network between you and the endpoint, not the credentials.

Related

Frequently asked questions

What base URL do I use for SillyTavern?

Use https://toolgram.app/api/v1 as the Custom Endpoint. It already includes the /v1 path, so do not add /v1 a second time. Select Chat Completion as the API and Custom (OpenAI-compatible) as the source, then paste your Toolgram key.

Why does SillyTavern say 401 Unauthorized?

The key is missing, expired, or has a trailing space. Copy it again from the API tab in the dashboard and paste it with no spaces. Keys are shown once at creation, so create a new one if you did not save it.

Why is the model list empty or a 404?

SillyTavern is asking for a model ID that the endpoint does not serve. Open toolgram.app/app/models, copy the exact ID, and paste it into the model field instead of relying on the fetch button. IDs are case sensitive.

Do I need to top up before testing?

Yes. Requests are paid from the prepaid balance, so an empty balance returns an error even with a valid key. Add at least $2 of USDT on TON. Credit does not expire, so a small test top-up is enough.

Does SillyTavern streaming work with Toolgram?

Yes. Streaming is supported through the OpenAI-compatible chat completions endpoint. If replies appear all at once or the connection drops, switch streaming off in SillyTavern first to confirm the key and model are correct, then turn it back on.

Can I use the same key on several devices?

Yes. A key is a normal bearer token and is not tied to one device. Create separate keys per device or per person if you want to revoke access independently, and keep each key out of shared screenshots and repositories.

Start with $2

Top up with USDT on TON, create a key, and point your client at one base URL. No card, no subscription, credit never expires.