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
- Create the key. Open toolgram.app/app, add funds, then create a key in the API tab and copy it.
- Open API Connections. In SillyTavern, click the plug icon in the top navigation bar.
- Set the API type. Choose
Chat Completionas the API. - Set the source. Choose
Custom (OpenAI-compatible). - Enter the endpoint. Paste
https://toolgram.app/api/v1into Custom Endpoint. The/v1is already part of the URL. - Paste the key. Put the Toolgram key in the API key field. Remove any trailing space.
- 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.
- 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.