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

# 快速開始

> 只需簡單三步驟，即可開始使用 MixRoute 串接各種 AI 模型。

## 第一步：創建帳號

進入 [MixRoute](https://api.mixroute.ai/) 或點擊畫面右上角【Get Started】創建您的帳號：

1. 點擊右上角「註冊」
2. 輸入郵件地址與設定密碼，並完成驗證
3. 點擊「錢包管理」，完成儲值（支援 Stripe 付款）

## 第二步：創建 API 密鑰

1. 在控制台導航點擊「API 密鑰管理」
2. 點擊「添加令牌」
3. 點擊「提交」生成 API 密鑰

## 第三步：開始使用

### 3.1 獲取接入資訊

| 配置項              | 值                            |
| ---------------- | ---------------------------- |
| API 地址（Base URL） | `https://api.mixroute.ai/v1` |
| API 密鑰           | 您創建的密鑰                       |
| 請求格式             | 完全兼容 OpenAI API              |

### 3.2 串接測試

使用 curl 快速測試：

```bash theme={null}
curl https://api.mixroute.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
```

### 3.3 程式碼範例

<Tabs>
  <Tab title="Python">
    ```python theme={null}
    from openai import OpenAI

    client = OpenAI(
        api_key="YOUR_API_KEY",
        base_url="https://api.mixroute.ai/v1"
    )

    response = client.chat.completions.create(
        model="gpt-5.5",
        messages=[
            {"role": "user", "content": "Hello!"}
        ]
    )

    print(response.choices[0].message.content)
    ```
  </Tab>

  <Tab title="Node.js">
    ```javascript theme={null}
    import OpenAI from 'openai';

    const openai = new OpenAI({
      apiKey: 'YOUR_API_KEY',
      baseURL: 'https://api.mixroute.ai/v1'
    });

    const response = await openai.chat.completions.create({
      model: 'gpt-5.5',
      messages: [{ role: 'user', content: 'Hello!' }]
    });

    console.log(response.choices[0].message.content);
    ```
  </Tab>

  <Tab title="Java">
    ```java theme={null}
    OpenAiService service = new OpenAiService(
        "YOUR_API_KEY", 
        Duration.ofSeconds(60), 
        "https://api.mixroute.ai/v1"
    );

    ChatCompletionRequest request = ChatCompletionRequest.builder()
        .model("gpt-5.5")
        .messages(List.of(
            new ChatMessage(ChatMessageRole.USER, "Hello!")
        ))
        .build();

    ChatCompletionResult result = service.createChatCompletion(request);
    System.out.println(result.getChoices().get(0).getMessage().getContent());
    ```
  </Tab>
</Tabs>

## 下一步

恭喜！您已經成功使用 MixRoute 接入 API 。接下來您可以：

<CardGroup cols={2}>
  <Card title="查看 API 文檔" icon="book" href="https://mixroute.ai" cta="瞭解更多">
    了解完整的 API 說明
  </Card>

  <Card title="開始應用" icon="puzzle-piece" href="https://mixroute.ai" cta="瞭解更多">
    將 MixRoute API 應用到各種工具
  </Card>
</CardGroup>

<Tip>
  保存好您的 API 密鑰，並定期在控制台查看使用日誌，合理優化成本。祝使用愉快\~
</Tip>