# Bắt đầu nhanh

Nguồn: https://docs.aicentos.com/vi/quickstart

Language: vi

> Tích hợp trong ba bước: đăng ký tài khoản → tạo API Key → điền Base URL và Key vào client

Tích hợp trong ba bước: **đăng ký tài khoản → tạo API Key → điền Base URL và Key vào client**.

## Bước 1: Đăng ký tài khoản

Mở [aicentos.com](https://aicentos.com/), nhấn "**Bắt đầu sử dụng**" ở góc trên bên phải để vào trang đăng ký:

Trang đăng ký

Điền **tên người dùng** và **mật khẩu**, tích đồng ý điều khoản dịch vụ rồi nhấn "Tạo tài khoản". Đăng ký được tặng ngay **¥1** tín dụng dùng thử, gọi API ngay mà không cần nạp tiền.

## Bước 2: Tạo API Key

Sau khi đăng nhập vào Console, ở menu bên trái nhấn "**API Key**", rồi nhấn "**Tạo API Key**" ở góc trên bên phải:

Trang API Key

Điền cấu hình trong hộp thoại rồi nhấn "Lưu thay đổi":

Tạo API Key

| Trường         | Mô tả                                                                                                           |
| -------------- | --------------------------------------------------------------------------------------------------------------- |
| Tên            | Tự đặt để phân biệt các dự án. Nên tạo riêng theo từng mục đích để thuận tiện tổng hợp chi phí và thu hồi quyền |
| Nhóm           | Chọn nhóm upstream; để trống sẽ dùng nhóm mặc định                                                              |
| Thời hạn       | Hỗ trợ "không bao giờ hết hạn" hoặc chọn 1 giờ / 1 ngày / 1 tháng                                               |
| Số lượng       | Tạo nhiều key cùng lúc, tên sẽ tự động thêm hậu tố ngẫu nhiên                                                   |
| Hạn mức vô hạn | Tắt đi thì có thể đặt giới hạn hạn mức cho key này                                                              |

Sau khi tạo xong, key sẽ xuất hiện trong danh sách dạng `sk-xxxxxxxxxxxx`, mặc định được che bớt:

Key đã tạo

Danh sách key hỗ trợ tìm kiếm theo tên và key; có thể xem nhóm, hạn mức, mô hình khả dụng, giới hạn IP... và chỉnh sửa hoặc xóa bất cứ lúc nào:

Danh sách key

> **Key chỉ hiển thị đầy đủ một lần duy nhất khi tạo**, hãy sao chép và lưu giữ ngay. Đừng hard-code vào code frontend hay commit lên repo công khai.

## Bước 3: Điền Base URL và Key vào client

### Chọn đúng Base URL trước

Đây là bước dễ sai nhất — **mỗi giao thức dùng một địa chỉ khác nhau**:

| Trường hợp sử dụng                                      | Base URL                  |
| ------------------------------------------------------- | ------------------------- |
| Codex / định dạng tương thích OpenAI                    | `https://aicentos.com/v1` |
| Claude Code / định dạng Anthropic, cùng các client khác | `https://aicentos.com`    |

> **Giao thức Anthropic chỉ điền địa chỉ gốc**, đừng tự thêm `/v1/messages`, client sẽ tự nối.

Ở trang "API Key" trong Console, bạn cũng có thể xem và sao chép trực tiếp từ menu thả xuống "**Địa chỉ API**" ở góc trên bên phải:

Địa chỉ API

### Kiểm tra kết nối

Chạy một request tối thiểu bằng curl để xác nhận Key và mạng hoạt động:

```bash
export AICENTOS_API_KEY="sk-key-của-bạn"

curl https://aicentos.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AICENTOS_API_KEY" \
  -d '{
    "model": "gemini-3.8-flash",
    "messages": [
      {"role": "user", "content": "Giới thiệu bản thân trong một câu"}
    ]
  }'
```

Cũng có thể gọi danh sách mô hình trước. Chỉ cần trả về JSON là key và Base URL đều dùng được:

```bash
export AICENTOS_API_KEY="sk-key-của-bạn"

curl https://aicentos.com/v1/models \
  -H "Authorization: Bearer $AICENTOS_API_KEY"
```

### Python (OpenAI SDK)

```python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AICENTOS_API_KEY"],
    base_url="https://aicentos.com/v1",
)

resp = client.chat.completions.create(
    model="gemini-3.8-flash",
    messages=[{"role": "user", "content": "Giới thiệu bản thân trong một câu"}],
)
print(resp.choices[0].message.content)
```

### Node.js (OpenAI SDK)

Ví dụ dùng cú pháp ESM, tên tệp phải là `.mjs`, hoặc thêm `"type": "module"` vào `package.json`:

```js
import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.AICENTOS_API_KEY,
  baseURL: 'https://aicentos.com/v1',
});

const resp = await client.chat.completions.create({
  model: 'gemini-3.8-flash',
  messages: [{ role: 'user', content: 'Giới thiệu bản thân trong một câu' }],
});

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

### Các client phổ biến

* [Tích hợp Claude Code](https://docs.aicentos.com/vi/claude-code) — import một chạm bằng CC Switch hoặc cấu hình thủ công
* [Tích hợp Codex](https://docs.aicentos.com/vi/codex) — cấu hình bằng giao diện hoặc tự viết config.toml
* [Tích hợp Cursor](https://docs.aicentos.com/vi/cursor) — tùy chỉnh cài đặt tương thích OpenAI
* [Tích hợp Cherry Studio](https://docs.aicentos.com/vi/cherry-studio) — thêm nhà cung cấp tương thích OpenAI

## Nạp tiền

Khi tín dụng tặng dùng hết, vào mục "**Ví**" ở menu bên trái của Console để nạp tiền:

Ví

Các mốc nạp và ưu đãi (**nạp từ ¥100 trở lên có chiết khấu, số tiền thực trả thấp hơn mức nạp**):

| Mức nạp              | Ưu đãi | Thực trả |
| -------------------- | ------ | -------- |
| ¥1 / ¥10 / ¥20 / ¥50 | Không  | Giá gốc  |
| ¥100                 | 1% OFF | ¥99      |
| ¥500                 | 2% OFF | ¥490     |
| ¥1,000               | 3% OFF | ¥970     |
| ¥10,000              | 5% OFF | ¥9,500   |

Cũng có thể nhập số tiền tùy ý, hoặc dùng mã đổi quà để nhận hạn mức.

Phương thức thanh toán

* **Phương thức thanh toán**: Alipay, WeChat, chuyển khoản doanh nghiệp
* **Hạn mức không bao giờ hết hạn**, tính phí theo token tiêu thụ thực tế
* Có thưởng giới thiệu: đăng ký qua link giới thiệu thì cả hai bên đều nhận thưởng, có thể chuyển vào số dư bất cứ lúc nào

## Xem mức sử dụng

Vào mục "**Dashboard**" ở menu bên trái của Console để xem chi tiết tiêu thụ:

Tổng quan Console

Bạn sẽ thấy số dư hiện tại, tổng mức dùng, số request API và xu hướng gọi theo từng mô hình:

Dashboard

## Thử ngay không cần viết code

Trong mục "**Chat**" ở đầu Console có Playground tích hợp sẵn, chọn mô hình, gửi tin nhắn và tinh chỉnh prompt ngay trong lúc trò chuyện:

Playground

## Bước tiếp theo

* Thử mô hình ngay trên trình duyệt trong [Playground](https://aicentos.com/playground), không cần viết code
* Xem [các mô hình hỗ trợ](https://docs.aicentos.com/vi/billing/models-list) — biết hỗ trợ những LLM nào
* Đọc [xử lý lỗi](https://docs.aicentos.com/vi/billing/errors) — xử lý lỗi 401, hết số dư...
* Tìm hiểu [quy tắc tính phí](https://docs.aicentos.com/vi/billing/pricing) — tính phí theo mức dùng và cảnh báo số dư