Skip to main content
First time with ruoli? Follow this single path and you’ll be up and running. None of the steps are hard — the key is picking the right group in Step 3, which is where new users most often get stuck.
1

Create an account

Go to ruoli.dev to sign up and log in. Sign up with QQ Mail or Gmail.
2

Add funds

Open the Wallet page in the console and top up; you can also redeem a gift code.You’re billed by actual token usage, so a small top-up is enough to try it out. See Billing & Top-Up.
3

Check the marketplace and decide on a group (important)

Open the model marketplace and confirm: which group your model is in, and its price.The group determines which models you can call. A token created with the wrong group will fail with “no available channel” on first call — so look before you create.If you don’t want to dig in, pick from this:Full details in Models & Groups.
4

Create an API Key (token)

  1. In the console, open the Tokens page and click Add Token
  2. Enter a token name
  3. Select the group (the one you decided on above)
  4. Pick available models as needed, or leave empty for all
  5. Click Create and copy the API Key
The API Key is shown only once — save it immediately. If lost, create a new one.
5

Configure your tool

Pick the tool you use and follow its page. Not sure? For coding, see Claude Code; for desktop chat, see Cherry Studio; for anything else, see General Access.

Claude Code

Anthropic’s AI coding agent

Codex

OpenAI’s AI coding agent

Cherry Studio

Cross-platform desktop AI chat client

General Access

Any tool with a custom API URL
6

Verify it works

After configuring, run this to confirm you get a valid response (replace sk-YOUR-KEY with your Key):
If the returned JSON contains reply text, you’re connected. If you hit an error, check the FAQ.