Skip to main content
This guide takes you from a blank screen to your first successful request to OpenAI / Claude / Gemini through RuAPI.
Don’t write code and just want to chat with AI? Cherry Studio is the easiest way. All options are on the docs home page.
Base URL — in your client this is the only thing you swap (click the icon at the top-right of each box to copy):OpenAI-compatible · Codex / n8n / OpenAI SDK — with /v1
Anthropic · Claude Code / Anthropic SDK / Claude in Cline — without /v1
⚠️ The Anthropic URL takes no /v1 — the SDK appends /v1/messages itself, so an extra /v1 returns 404.

Step 1. Sign up

Open www.ruapi.ai and click Sign up, then Sign up with email. Enter a username, password, email and the verification code that arrives in your inbox. Or skip that and sign in with a Google or Yandex account.
RuAPI sign-up page: continue with Google or Yandex, or sign up with email

Sign up with email, or in one click with Google or Yandex

Didn’t get the email? Check your Spam folder. Still nothing — write to support@ruapi.ai.

Step 2. Top up (USDT / USDC or card)

Once logged in, go to Wallet and pick an amount to top up. Minimum is $5, in USDT / USDC or by card.
RuAPI top-up page: amounts from 10 to 500 dollars, pay with USDT or a card

The Wallet page: pick an amount and a payment method

Send USDT or USDC only via the network you selected when paying (TRC20 / BEP20 / TON / Polygon). Sending via a different network will result in permanent loss of funds.
After the on-chain transaction is confirmed (typically 1–5 minutes), your balance updates automatically.

Step 3. Create an API key

In the Console, go to API Keys → Create API key.
  • Name: anything for your own reference, e.g. local-dev.
  • Expiration time: leave it at Never expires unless you have a reason not to.
  • Credit limit: you can cap the key at a USD amount.
RuAPI API Keys page: the Create API key button and the copy key button

The Create API key button adds a key; the icon next to the key opens the copy menu

Copy the resulting key — it starts with sk-.... Save it somewhere safe; you can view the full key any time on the API Keys page in the Console.
You can copy ready-made settings with your key for Claude Code, Cline, Kilo Code, OpenCode and Cherry Studio, plus Python and curl request examples, on Console → API Keys: click Connect Claude Code, Cline & more and pick the app (or Python / curl).
RuAPI API Keys page: the https://www.ruapi.ai address and the “Connect Claude Code, Cline & more” button

Console → API Keys: the “Connect Claude Code, Cline & more” button

Step 4. Base URL (base_url)

RuAPI supports two protocols, and the address differs between them — this is the #1 thing people get wrong:
For Anthropic, do not append /v1 to the URL. The SDK adds /v1/messages itself, and an extra /v1 results in a 404. See the Claude Code and Codex guides.

Step 5. First request

Example for the OpenAI-compatible protocol — use any OpenAI SDK you like and just swap the base_url:

Step 6. Switch models

To switch to another model, change only the model parameter:
The full list of available models is on the Pricing page at www.ruapi.ai.

What’s next