ima: mô hình tùy chỉnh, API Key, Base URL và sửa lỗi
Cấu hình API Key, Base URL và ID mô hình chính xác trong ima. Kiểm tra phản hồi, xử lý lỗi và phân biệt mô hình chat với quyền truy cập API kho kiến thức.
Hướng dẫn này kết nối ima với API mô hình chat bên ngoài. Dùng phiên bản có mục thêm mô hình tùy chỉnh; menu máy tính và điện thoại có thể khác nhau. API Key và Base URL phải từ cùng nhà cung cấp. Sao chép ID chính xác từ danh sách hiện tại; mô hình trong ảnh cũ chỉ là ví dụ. Không nhập toàn bộ URL yêu cầu /chat/completions hoặc lặp /v1. Giữ giới hạn độ dài mặc định và thử câu hỏi ngắn. Lưu cấu hình chưa xác nhận gọi API thành công.
ima: mô hình tùy chỉnh, API Key, Base URL và sửa lỗi
Bước 1: Mở lối vào chọn mô hình
Ở cuối giao diện hội thoại của ima copilot, tìm nút “DS Nhanh” (khung đỏ trong hình 1), nhấp vào đó để mở menu chọn mô hình.
Hình này hiển thị giao diện ứng dụng ima trên điện thoại, nằm trong ngữ…
Bước 2: Vào “Thêm mô hình tùy chỉnh”
Trong menu mô hình, tìm nút “Thêm mô hình tùy chỉnh” rồi nhấp vào để vào trang cấu hình mô hình tùy chỉnh.
Hình này hiển thị giao diện thêm mô hình tùy chỉnh trên điện thoại. Phía…
Bước 3: Chọn nhà cung cấp mô hình (có thể chọn “Tùy chỉnh”)
Trong trang “Thêm mô hình tùy chỉnh”, nhấp vào hộp chọn thả xuống “Nhà cung cấp mô hình” (như hình 4), bạn có thể chọn các nhà cung cấp cài sẵn (như DeepSeek, Kimi, Z.ai...); nếu cần kết nối mô hình bên thứ ba / tự dựng, hãy chọn “+ Tùy chỉnh” (mặc định đã chọn “Tùy chỉnh”, có thể bỏ qua trực tiếp bước này).
Hình này thể hiện giao diện chọn nhà cung cấp mô hình khi thêm mô hình t…
Bước 4: Điền thông tin cốt lõi của mô hình
Trên trang cấu hình, cần điền 3 nội dung quan trọng (khung đỏ trong hình 5):
- Địa chỉ giao diện: nhập địa chỉ API của mô hình (ví dụ như
https://api.llm-token.cn/v1trong mẫu, cần thay bằng địa chỉ thực mà bạn muốn kết nối). - API Key: nhập API key của mô hình (định dạng tương tự
sk-xxxxxx..., cần lấy từ nhà cung cấp dịch vụ mô hình). - Tên mô hình: nhập tên mô hình (ví dụ
gpt-5.5,claude-sonnet-4-6, cần trùng với tên mô hình mà giao diện hỗ trợ).
Cấu hình nâng cao (độ dài đầu vào/đầu ra) có thể giữ “sử dụng giá trị mặc định”, không cần chỉnh sửa.
Đây là giao diện cấu hình để thêm mô hình tùy chỉnh, dùng để hoàn tất th…
Bước 5: Lưu mô hình tùy chỉnh
Sau khi điền xong, nhấp nút “Lưu” ở góc trên bên phải (theo chỉ dẫn ngón tay trong hình 5), mô hình tùy chỉnh sẽ tự động được thêm vào danh sách “Mô hình tùy chỉnh” (như hình 6, mô hình mới claude-opus-4-8 đã được thêm thành công và có thể chuyển sang dùng).
Sử dụng về sau: Chuyển đổi mô hình tùy chỉnh
Quay lại menu chọn mô hình (nút “DS Nhanh” ở bước 1), bạn sẽ thấy mô hình đã thêm trong danh sách “Mô hình tùy chỉnh” (như hình 6), chỉ cần nhấp vào là có thể chuyển sang dùng.
Hình này hiển thị giao diện menu chọn mô hình trên điện thoại. Phía trên…
Xử lý lỗi yêu cầu mô hình tùy chỉnh
| Hiện tượng | Kiểm tra trước |
|---|---|
| Lỗi xác thực hoặc 401 | Key đầy đủ, còn hiệu lực và do nhà cung cấp địa chỉ này phát hành. |
| Không tìm thấy mô hình hoặc thiếu quyền | ID đúng trong danh sách hiện tại và quyền truy cập của Key. |
| 404 hoặc không tìm thấy giao diện | Base URL, đường dẫn yêu cầu đầy đủ và phần lặp /v1/v1. |
| Lưu được nhưng gửi thất bại | Đã chọn cấu hình mới, số dư, trạng thái dịch vụ và mạng. |
| Câu ngắn thành công, nội dung dài thất bại | Giới hạn đầu vào/đầu ra, ngân sách ngữ cảnh và giới hạn nhà cung cấp. |
Khi liên hệ hỗ trợ, gửi thời gian, ID mô hình, lỗi đầy đủ và ID yêu cầu nếu có. Ẩn API Key.
Mô hình chat và API kho kiến thức ima
Cấu hình này cho phép ima gọi mô hình chat bên ngoài. Để agent bên ngoài đọc hoặc ghi kho kiến thức ima, cần kiểm tra riêng giao diện chính thức, xác thực và quyền truy cập. Lưu mô hình chat không thiết lập quyền này.
Xác nhận ID mô hình và giá
Sao chép ID chính xác từ danh mục hiện tại của nhà cung cấp. Kiểm tra riêng giá đầu vào, đầu ra và bộ nhớ đệm; không suy ra mô hình hay giá hiện tại từ ảnh cũ.
Mô hình và cách tính phí hiện tại
Đầu vào, đầu ra và đầu vào được lưu đệm có thể có đơn giá khác nhau. Với mô hình ảnh, video hoặc tính theo yêu cầu, hãy kiểm tra đơn vị tính phí. Xem ID và đơn giá trên trang giá hiện tại; phí thực tế được ghi trong lịch sử thanh toán.