44 lines
1.7 KiB
Markdown
44 lines
1.7 KiB
Markdown
---
|
|
summary: "Cổng HTTP /v1/chat/completions tương thích với OpenAI từ Gateway"
|
|
read_when:
|
|
- Bạn muốn dùng các ứng dụng hoặc công cụ vốn được thiết kế cho OpenAI để kết nối với Moltbot
|
|
---
|
|
|
|
# API tương thích OpenAI (HTTP)
|
|
|
|
Gateway của Moltbot cung cấp một cổng (endpoint) nhỏ tương thích với chuẩn OpenAI Chat Completions. Tính năng này **bị tắt theo mặc định**. Để sử dụng, bạn cần bật nó trong tệp cấu hình.
|
|
|
|
- **Địa chỉ**: `POST /v1/chat/completions`
|
|
- **Cổng**: Cùng cổng với Gateway (Ví dụ: `http://localhost:18789/v1/chat/completions`).
|
|
|
|
Về bản chất, các yêu cầu gửi đến đây sẽ được thực thi như một lượt chạy Agent bình thường trong Moltbot.
|
|
|
|
## Xác thực
|
|
Sử dụng mã xác thực Gateway của bạn. Gửi mã này trong tiêu đề (header) của yêu cầu:
|
|
`Authorization: Bearer <token_cua_ban>`
|
|
|
|
## Chọn Agent
|
|
Bạn không cần thêm tiêu đề tùy chỉnh, chỉ cần ghi ID của Agent vào trường `model` trong yêu cầu OpenAI:
|
|
- `model: "moltbot:main"` (Dùng Agent tên 'main')
|
|
- `model: "agent:beta"` (Dùng Agent tên 'beta')
|
|
|
|
## Bật tính năng này
|
|
Thêm đoạn sau vào tệp cấu hình `moltbot.json`:
|
|
```json5
|
|
{
|
|
"gateway": {
|
|
"http": {
|
|
"endpoints": {
|
|
"chatCompletions": { "enabled": true }
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## Luồng dữ liệu (Streaming)
|
|
Hỗ trợ đầy đủ chế độ `stream: true` để nhận kết quả ngay khi AI vừa tạo ra từng chữ (Server-Sent Events).
|
|
|
|
---
|
|
Tài liệu liên quan: [Cấu hình hệ thống](./configuration.vi.md), [Nhà cung cấp AI](../concepts/model-providers.vi.md).
|