> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 快速入门

> 从注册到调用第一次 LLM —— 5 分钟

本文带你从零开始，5 分钟内跑通对 OpenAI / Claude / Gemini 的第一次调用。

<Tip>
  **接口地址 Base URL** —— 在客户端里只需替换这一项（点代码框右上角即可复制）：

  **OpenAI 兼容** · Cursor / Cline / Codex / OpenAI SDK —— 带 `/v1`

  ```bash theme={null}
  https://www.ruapi.ai/v1
  ```

  **Anthropic** · Claude Code / Anthropic SDK —— 不带 `/v1`

  ```bash theme={null}
  https://www.ruapi.ai
  ```

  ⚠️ Anthropic 端点**不要**加 `/v1`，SDK 会自动补 `/v1/messages`，多写会 404。
</Tip>

## 第 1 步 注册

打开 [www.ruapi.ai](https://www.ruapi.ai)，点击 **「注册」**。
填邮箱、密码，输入收到的验证码即可。

<Tip>
  没收到邮件？先看 Spam 文件夹。还是没有就联系
  [support@ruapi.ai](mailto:support@ruapi.ai)。
</Tip>

## 第 2 步 充值（USDT / USDC 或银行卡）

登录后进入 **「钱包管理」**，选择金额。最低 **5 USDT / USDC**。

<Warning>
  USDT / USDC 转账时**只能使用支付页选择的网络**（TRC20 / BEP20 / Polygon）。通过其他网络转账将**永久丢失资产**。
</Warning>

链上交易确认后（通常 1-5 分钟），余额自动到账。

## 第 3 步 创建 API key

控制台进入 **「令牌」** → **「创建令牌」**：

* **名称**：自定义，方便区分，例如 `local-dev`
* **过期时间**：默认「无限制」即可
* **额度上限**：可以限制此 token 的最大花费

复制生成的 key，开头是 `sk-...`。妥善保存；之后如果需要，在控制台 **「令牌」** 页随时可以再次查看完整 key。

## 第 4 步 基础地址（base\_url）

RuAPI 同时支持**两种协议**，两者的地址**不一样**——这是最容易填错的地方：

| 协议            | `base_url` 填什么                           | 谁在用                           |
| ------------- | ---------------------------------------- | ----------------------------- |
| **OpenAI 兼容** | `https://www.ruapi.ai/v1`  ← **带 `/v1`** | Cursor、Cline、Codex、OpenAI SDK |
| **Anthropic** | `https://www.ruapi.ai`  ← **不带 `/v1`**   | Claude Code、Anthropic SDK     |

<Warning>
  Anthropic 端点**不要**在末尾加 `/v1`。SDK 会自动补 `/v1/messages`，多写一个
  `/v1` 会导致 **404**。详见 [Claude Code](/zh/integrations/claude-code) 与
  [Codex](/zh/integrations/codex) 集成指南。
</Warning>

## 第 5 步 第一次调用

以下是 OpenAI 兼容协议的示例，直接用现有 SDK，只改 `base_url`：

<CodeGroup>
  ```python Python (OpenAI SDK) theme={null}
  from openai import OpenAI

  client = OpenAI(
      api_key="sk-你的KEY",
      base_url="https://www.ruapi.ai/v1",
  )

  response = client.chat.completions.create(
      model="claude-opus-4-8",  # 准确的模型名见主站价格页面
      messages=[{"role": "user", "content": "你好"}],
  )

  print(response.choices[0].message.content)
  ```

  ```javascript Node.js (OpenAI SDK) theme={null}
  import OpenAI from "openai";

  const client = new OpenAI({
    apiKey: "sk-你的KEY",
    baseURL: "https://www.ruapi.ai/v1",
  });

  const response = await client.chat.completions.create({
    model: "claude-opus-4-8", // 准确的模型名见主站价格页面
    messages: [{ role: "user", content: "你好" }],
  });

  console.log(response.choices[0].message.content);
  ```

  ```bash curl theme={null}
  curl https://www.ruapi.ai/v1/chat/completions \
    -H "Authorization: Bearer sk-你的KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "claude-opus-4-8",
      "messages": [{"role": "user", "content": "你好"}]
    }'
  ```
</CodeGroup>

## 第 6 步 切换模型

切换模型只需改 `model` 字段：

```python theme={null}
# 改 model 字段即可切换模型。准确的模型名见主站价格页面
model="claude-opus-4-8"
```

完整模型列表见 **首页 → 价格** 页。

## 接下来

* [价格与计费规则](/zh/pricing) —— 每次调用怎么扣费
* 有问题？[support@ruapi.ai](mailto:support@ruapi.ai)