Custom API endpoint: cách kết nối API tương thích OpenAI
Custom API endpoint và Base URL là gì, cách kết nối API tương thích OpenAI, relay, proxy hay gateway chỉ với một địa chỉ và một API key.
- Custom API endpoint (endpoint tùy chỉnh) là địa chỉ web, hay Base URL, của một dịch vụ AI không có sẵn trong app của bạn, chẳng hạn một API tương thích OpenAI, một relay (trạm trung chuyển), một proxy hay một gateway. Trong Oriveo, thường bạn chỉ cần hai thứ để kết nối: địa chỉ đó và một API key.
- Oriveo tự xác định giao thức giúp bạn (OpenAI Chat Completions, OpenAI Responses, Anthropic Messages hoặc Gemini) và tự thêm đường dẫn phiên bản, như /v1, khi bạn chỉ nhập địa chỉ gốc.
- Địa chỉ công khai bắt buộc dùng HTTPS. Dịch vụ bên thứ ba thấy được mọi thứ bạn gửi qua nó, nên hãy dùng một key riêng có hạn mức chi tiêu cho dịch vụ đó, và đừng bao giờ đưa key chính thức của nhà cung cấp cho họ.

Base URL hay API endpoint là gì?
Mỗi dịch vụ AI có một địa chỉ web để app gửi yêu cầu tới. Lập trình viên gọi nó là Base URL, API endpoint hay URL yêu cầu; ở đây cả ba đều chỉ cùng một thứ. Nó trông giống một địa chỉ web bình thường, ví dụ của OpenAI là https://api.openai.com/v1.
Trong Oriveo, 15 nhà cung cấp có sẵn đều đã được điền địa chỉ, nên bạn chỉ việc dán key. Endpoint tùy chỉnh dành cho mọi thứ còn lại: một dịch vụ có API tương thích OpenAI, một relay hay gateway do một công ty vận hành, hoặc một gateway bạn tự chạy trên máy chủ của mình.
“Tương thích OpenAI” (OpenAI-compatible) nghĩa là dịch vụ nhận yêu cầu theo đúng định dạng của API OpenAI, nên app làm cho OpenAI cũng nói chuyện được với nó. Nhiều nhà cung cấp và gateway có định dạng này.
Relay, proxy, gateway khác nhau thế nào?
Người ta dùng mấy từ này khá lẫn lộn, và khi kết nối từ app thì chúng hoạt động giống nhau: một dịch vụ đứng giữa app của bạn và các nhà cung cấp mô hình, nhận yêu cầu rồi chuyển tiếp đi. Có dịch vụ gom nhiều nhà cung cấp vào một key và một hóa đơn; có dịch vụ thêm công cụ kiểm soát mức dùng cho nhóm; có cái là phần mềm bạn tự chạy trên máy chủ của mình.
Oriveo không giới thiệu hay xếp hạng dịch vụ nào. Dù bạn dùng loại nào, các bước bên dưới đều như nhau.
Cần gì để kết nối một endpoint tùy chỉnh?
Thường là hai thứ, đều lấy từ trang quản lý hoặc tài liệu của chính dịch vụ đó:
- URL yêu cầu (Base URL), ví dụ https://api.example.com/v1. Nếu dịch vụ nằm trên internet công khai, địa chỉ phải bắt đầu bằng https://.
- Một API key do dịch vụ đó cấp cho bạn. Bạn có thể thêm nhiều key bằng “Thêm khóa khác”.
- Không bắt buộc: một cái tên cho kết nối, để phân biệt với các kết nối khác.
Cách thêm endpoint tùy chỉnh trong Oriveo
Các bước giống nhau trên iPhone, Android và web.
- Mở Nhà cung cấp và bấm nút + (Thêm nhà cung cấp).
- Chọn chip Tùy chỉnh, rồi chọn Rơ-le tùy chỉnh (“Kết nối dịch vụ mô hình của riêng bạn”).
- Ở màn hình “Kết nối rơ-le tùy chỉnh”, dán URL yêu cầu và API key. Dòng “Sẽ gửi yêu cầu tới …” cho thấy địa chỉ đầy đủ mà Oriveo sẽ dùng. Bấm Tiếp theo.
- Oriveo kiểm tra kết nối, đọc danh sách mô hình và xác định giao thức của từng mô hình. Bước này chỉ đọc danh sách, không gửi tin nhắn chat nào.
- Đánh dấu các mô hình bạn muốn và bấm “Lưu (đã chọn N)”. Nếu dịch vụ không liệt kê mô hình, hãy dùng “Thêm ID mô hình thủ công”.
- Trước khi lưu, Oriveo gửi một yêu cầu rất nhỏ tới mô hình đầu tiên bạn chọn. Kết nối được lưu khi phép thử này thành công; nếu thất bại, bạn vẫn ở bước đó và có thể sửa lại.

Muốn tự thiết lập mọi thứ? Dùng Thiết lập thủ công
Thiết lập thủ công gom mọi thứ vào một trang: địa chỉ, key, ID mô hình, tên kết nối (không bắt buộc) và giao thức mặc định, ban đầu để tự động. Bấm “Xác minh và lưu”. Nếu kiểm tra thất bại thì chưa có gì được lưu, và thẻ báo lỗi có nút “Vẫn lưu (chưa xác minh)” nếu bạn muốn giữ kết nối để thử lại sau.
Oriveo có tự nhận diện giao thức không?
Phần lớn là có. Các dịch vụ AI dùng một trong vài định dạng yêu cầu, gọi là giao thức. Oriveo hỗ trợ bốn loại: OpenAI Chat Completions, OpenAI Responses, Anthropic Messages và Gemini generateContent.
Oriveo quyết định theo từng mô hình. Nếu dịch vụ có cung cấp thông tin về mô hình, Oriveo dùng thông tin đó; nếu không, Oriveo chọn các ứng viên khả dĩ dựa trên dòng (family) của mô hình. Khi bạn lưu, mô hình đầu tiên được chọn sẽ được thử bằng một yêu cầu thật; các mô hình khác được kiểm tra sau, khi bạn bắt đầu dùng.
Vì vậy trong đa số trường hợp, chỉ cần địa chỉ và key là đủ. Nếu tài liệu của dịch vụ nêu rõ một giao thức cụ thể, hoặc một mô hình không qua được bước kiểm tra, hãy tự chọn giao thức trong Thiết lập thủ công.
Có cần thêm /v1 vào địa chỉ không?
Thường là không. Nếu bạn chỉ nhập địa chỉ gốc, như https://api.example.com, Oriveo sẽ thêm đường dẫn phiên bản chuẩn của giao thức: /v1 cho định dạng OpenAI và Anthropic, /v1beta cho Gemini.
Nếu địa chỉ đã có phiên bản, như /api/paas/v4, Oriveo giữ nguyên. Nếu bạn dán cả endpoint đầy đủ kết thúc bằng /chat/completions, /responses, /messages hoặc :generateContent, Oriveo bỏ phần đuôi đó và dựa vào nó để biết dịch vụ dùng giao thức nào.
Hãy xem dòng “Sẽ gửi yêu cầu tới …” trước khi bấm Tiếp theo. Nếu bước kiểm tra báo “Địa chỉ có thể đang trỏ tới một trang web. Hãy kiểm tra xem có thiếu /v1 không.”, hãy so địa chỉ của bạn với tài liệu của dịch vụ.
| Bạn nhập | Oriveo gửi yêu cầu tới (định dạng OpenAI) |
|---|---|
| https://api.example.com | https://api.example.com/v1 |
| https://api.example.com/v1 | https://api.example.com/v1 |
| https://api.example.com/v1/chat/completions | https://api.example.com/v1, dùng Chat Completions |
| https://api.example.com/api/paas/v4 | https://api.example.com/api/paas/v4 |
Những địa chỉ nào được chấp nhận?
Oriveo tuân theo vài quy tắc để bảo vệ key của bạn:
- Địa chỉ công khai phải bắt đầu bằng https://. Địa chỉ http:// trên internet công khai không thể thử hay lưu.
- Không chấp nhận địa chỉ có chứa tên đăng nhập và mật khẩu, hoặc có tham số truy vấn (mọi thứ sau dấu “?”). Oriveo không bao giờ thử lấy API key từ tham số truy vấn.
- Địa chỉ http:// thông thường trong mạng gia đình hoặc VPN riêng, như máy chủ mô hình chạy trên máy tính của bạn, thì dùng mục riêng là Điện toán cục bộ (trên iPhone là “Điện toán cục bộ và LAN”) thay vì Rơ-le tùy chỉnh.
- Trên iPhone và Android, app kết nối thẳng tới địa chỉ đó.
- Trên bản web, URL yêu cầu công khai được chuyển qua máy chủ Oriveo để vượt qua giới hạn CORS của trình duyệt (một quy tắc bảo mật của trình duyệt, chặn nhiều yêu cầu gửi thẳng). API key của bạn chỉ nằm trong bộ nhớ cho yêu cầu đó, không bao giờ được lưu trữ hay ghi log. Địa chỉ trong mạng nội bộ kết nối trực tiếp từ thiết bị của bạn, và cả hai trường hợp đều yêu cầu HTTPS; địa chỉ http:// thông thường trong mạng gia đình thì cần app iPhone hoặc Android và mục Điện toán cục bộ của app.
- Key chỉ lưu trên thiết bị này và không được tải lên qua đồng bộ đám mây.
Base URL của các nhà cung cấp có sẵn
Trong Oriveo bạn không cần những địa chỉ này: cứ chọn nhà cung cấp theo tên. Chúng được liệt kê vì nhiều người hay tra để dùng cho công cụ khác. Mỗi địa chỉ là Base URL tương thích OpenAI chính thức ghi trong tài liệu của nhà cung cấp, tính đến ngày 18 tháng 11 năm 2026.
- Anthropic mô tả lớp tương thích OpenAI của họ là để thử nghiệm và so sánh, còn phần hướng dẫn nhanh (quickstart) của Mistral không mô tả API của họ là tương thích OpenAI. Hãy thêm cả hai dưới dạng nhà cung cấp có sẵn.
| Nhà cung cấp | Base URL tương thích OpenAI |
|---|---|
| OpenAI | https://api.openai.com/v1 |
| Google Gemini | https://generativelanguage.googleapis.com/v1beta/openai/ |
| OpenRouter | https://openrouter.ai/api/v1 |
| DeepSeek | https://api.deepseek.com |
| xAI (Grok) | https://api.x.ai/v1 |
| Groq | https://api.groq.com/openai/v1 |
| Together AI | https://api.together.ai/v1 |
| Fireworks AI | https://api.fireworks.ai/inference/v1 |
| MiniMax (quốc tế) | https://api.minimax.io/v1 |
| Z.ai (quốc tế) | https://api.z.ai/api/paas/v4/ |
| Qwen (khu vực Singapore) | https://dashscope-intl.aliyuncs.com/compatible-mode/v1 |
| Kimi (quốc tế) | https://api.moonshot.ai/v1 |
| SiliconFlow (quốc tế) | https://api.siliconflow.com/v1 |
Dùng relay hay API bên thứ ba có an toàn không?
Hãy cẩn thận. Bất kỳ dịch vụ nào đứng giữa bạn và mô hình đều đọc được prompt, tệp bạn đính kèm và câu trả lời, và họ tự đặt giá của mình. Oriveo không nhìn được bên trong dịch vụ đó và không thể bảo đảm cho nó.
- Đừng bao giờ đưa API key từ tài khoản chính thức của nhà cung cấp cho dịch vụ bên thứ ba. Hãy dùng key mà dịch vụ đó cấp cho bạn.
- Tạo một key riêng cho Oriveo, và đặt hạn mức chi tiêu hoặc chỉ để số dư nhỏ trên key đó nếu dịch vụ cho phép.
- Đừng gửi mật khẩu, số giấy tờ tùy thân hay tài liệu công việc mật qua dịch vụ bạn không tin tưởng.
- Kiểm tra mức dùng trên trang quản lý của chính dịch vụ. Số liệu chi phí của Oriveo là ước tính; dữ liệu của dịch vụ mới là con số cuối cùng.
- Nếu key bị lộ, hãy xóa nó trên trang quản lý của dịch vụ và tạo key mới.
Vì sao endpoint tùy chỉnh không kết nối được?
Oriveo cho bạn biết lỗi nằm ở đâu chỉ bằng một dòng. Nguyên văn các thông báo trên giao diện tiếng Việt:
- Với các mã như 401, 402 và 429, bài hướng dẫn về lỗi API key của chúng tôi giải thích ý nghĩa của từng mã.
| Thông báo trong Oriveo | Cần kiểm tra gì |
|---|---|
| Địa chỉ có thể đang trỏ tới một trang web. Hãy kiểm tra xem có thiếu /v1 không. | So địa chỉ với tài liệu của dịch vụ; thêm hoặc bỏ đường dẫn phiên bản |
| Khóa không hợp lệ. | Sao chép lại key từ trang quản lý của dịch vụ |
| Khóa này không có quyền xem danh sách mô hình. Bạn có thể thêm mô hình theo cách thủ công. | Tự thêm ID mô hình ở bước tiếp theo |
| Không kết nối được. Hãy kiểm tra mạng hoặc proxy. | Kiểm tra kết nối internet và xem địa chỉ có truy cập được không |
| Dịch vụ tại địa chỉ này đang giới hạn tốc độ yêu cầu. | Chờ một chút rồi thử lại |
| Kết nối này không liên lạc được với nhà cung cấp thượng nguồn. | Tài khoản của chính dịch vụ phía sau có thể không hợp lệ, hết credit hoặc bị giới hạn tốc độ; hãy liên hệ bên vận hành dịch vụ |
Câu hỏi thường gặp
Custom API endpoint là gì?
API tương thích OpenAI là gì?
Nên nhập Base URL nào?
Dùng endpoint tùy chỉnh trên iPhone và Android được không?
Vì sao Oriveo bắt buộc dùng HTTPS?
Dùng API relay hay proxy có an toàn không?
Bài liên quan
Từ blog
Kết nối dịch vụ mô hình của riêng bạn
Mở bản web hoặc tải Oriveo cho iPhone hay Android, chọn Rơ-le tùy chỉnh rồi dán địa chỉ và key từ dịch vụ của bạn.
Chưa có API key? Hãy bắt đầu với Oriveo Free.