# Kimi

Nguồn: https://docs.aicentos.com/vi/clients/kimi

Language: vi

> Dùng aicentos trong Kimi Code CLI —— đăng ký provider OpenAI tương thích qua config.toml

Kimi Code CLI cho phép đăng ký dịch vụ OpenAI tương thích bất kỳ thành provider. Trỏ `base_url` về aicentos, điền API Key, là có thể gọi trực tiếp các mô hình aicentos tích hợp ngay trong giao diện terminal.

## Chuẩn bị

Trước tiên, tạo một Key chuyên dụng cho Kimi Code tại trang "API Key" trong Console (khuyến nghị đặt tên `kimi-cli` để dễ theo dõi mức sử dụng).

* Console: [https://aicentos.com](https://aicentos.com)
* Tạo Key: [https://aicentos.com/keys](https://aicentos.com/keys)
* Nạp tiền Ví: [https://aicentos.com/wallet](https://aicentos.com/wallet)
* Trang tài liệu: [https://docs.aicentos.com](https://docs.aicentos.com)

File cấu hình mặc định nằm ở `~/.kimi/config.toml`, khi chạy Kimi Code lần đầu sẽ tự động được tạo.

## Cấu hình cần điền

| Trường        | Giá trị                                      |
| ------------- | -------------------------------------------- |
| Loại provider | `openai_legacy` (giao thức Chat Completions) |
| base\_url     | `https://aicentos.com/v1`                    |
| api\_key      | Key tạo trong Console                        |
| model         | tên mô hình trong "Model Square" của Console |

Nếu phía aicentos đi giao thức Responses, đổi loại thành `openai_responses` là được.

## Các bước thiết lập

Mở `~/.kimi/config.toml`, bổ sung một provider tùy chỉnh và một bí danh mô hình:

```toml
default_model = "aicentos-gpt-4o"

[providers.aicentos]
type = "openai_legacy"
base_url = "https://aicentos.com/v1"
api_key = "sk-key-của-bạn"

[models.aicentos-gpt-4o]
provider = "aicentos"
model = "gpt-4o"
max_context_size = 128000
```

* Tên provider (`aicentos`) và bí danh mô hình (`aicentos-gpt-4o`) đều có thể tự đặt, trong `default_model` ghi là bí danh, không phải model ID phía máy chủ.
* Nếu bí danh có dấu `.` (ví dụ `gpt-4.1`), trong TOML bắt buộc phải thêm dấu ngoặc kép: `[models."gpt-4.1"]`, nếu không dấu `.` sẽ bị coi là ký tự phân tách bảng.
* Nếu không muốn viết TOML bằng tay, trong TUI nhập `/provider` để mở trình quản lý nhà cung cấp, nhấn Enter ở dòng `[ Add New Platform ]`, thêm theo wizard.

Cũng có thể chỉ dùng biến môi trường (có hiệu lực với loại `openai_legacy` / `openai_responses`):

```bash
export OPENAI_BASE_URL="https://aicentos.com/v1"
export OPENAI_API_KEY="sk-key-của-bạn"
```

## Kiểm tra

Khởi động `kimi`, trong TUI gửi một câu prompt đơn giản, trả về bình thường tức là kết nối thành công. Dùng `/model` xác nhận hiện đang chọn đúng bí danh vừa cấu hình.

## Lưu ý

* Thông tin xác thực của provider được phân giải theo thứ tự: trường `api_key` > bảng con `[providers.<name>.env]` > báo lỗi khi khởi động; ngoài `openai_legacy` / `openai_responses`, thông tin xác thực trong file cấu hình sẽ không được tự động bổ sung từ biến môi trường shell.
* `type = "kimi"` là dành cho endpoint chính thức của Moonshot, khi kết nối aicentos hãy dùng `openai_legacy` hoặc `openai_responses`.
* Đừng điền `max_context_size` thấp hơn cửa sổ thực tế của mô hình, điền nhỏ sẽ sớm kích hoạt nén ngữ cảnh.
* Base URL chỉ điền đến `/v1`, đừng bổ sung thành đường dẫn đầy đủ `/v1/chat/completions`.
* Tên mô hình lấy "Model Square" trong Console làm chuẩn (tham khảo [Các mô hình hỗ trợ](https://docs.aicentos.com/vi/billing/models-list)).