# Jcode

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

Language: vi

> Dùng aicentos trong Jcode —— chỉ định endpoint OpenAI tương thích qua file cấu hình

Jcode hỗ trợ chỉ định dịch vụ API OpenAI tương thích qua file cấu hình. Trỏ Base URL về aicentos, điền API Key, là có thể dùng các mô hình aicentos tích hợp trong Jcode.

## Chuẩn bị

Trước tiên, tạo một Key chuyên dụng cho Jcode tại trang "API Key" trong Console (khuyến nghị đặt tên `jcode` để 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)

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

| Trường   | Giá trị                                      |
| -------- | -------------------------------------------- |
| Provider | OpenAI Compatible                            |
| 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 |

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

* Mở file cấu hình của Jcode (thường nằm trong thư mục cấu hình người dùng, dạng `~/.jcode/config.json`).
* Thêm một mục provider OpenAI tương thích.
* `baseURL` / `baseUrl` điền: `https://aicentos.com/v1`
* `apiKey` điền Key tạo trong Console.
* `model` điền tên mô hình trong "Model Square" của Console (tham khảo [Các mô hình hỗ trợ](https://docs.aicentos.com/vi/billing/models-list)).
* Sau khi lưu, khởi động lại Jcode để cấu hình có hiệu lực.

Cấu trúc tham khảo:

```json
{
  "provider": "openai",
  "baseUrl": "https://aicentos.com/v1",
  "apiKey": "sk-key-của-bạn",
  "model": "gpt-4o"
}
```

Nếu phiên bản của bạn đặt cấu hình ở `~/.config/jcode/config.json`, sửa file cùng tên dưới đường dẫn đó là được.

## Kiểm tra

Sau khi khởi động lại, tạo một phiên hội thoại mới, 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.

## Lưu ý

* Cách đặt tên mục cấu hình (`baseUrl` / `base_url`) có thể khác nhau giữa các phiên bản, lấy tên trường trong mẫu cấu hình cục bộ của bạn làm chuẩn.
* Base URL chỉ điền đến `/v1`, đừng bổ sung thành đường dẫn API đầy đủ.
* Nếu phiên bản Jcode không cung cấp mục nhập Base URL tùy chỉnh, thì phiên bản đó không thể kết nối endpoint bên thứ ba, hãy đổi sang client khác hỗ trợ Base URL tùy chỉnh.
* Đừng commit Key vào kho mã nguồn, khi cần có thể tham chiếu qua biến môi trường.