Tài liệu
Amp
Amp định tuyến mô hình ở phía máy chủ, nên không có biến URL cơ sở nào cần đặt trên máy của bạn — bạn thêm kết nối URL tùy chỉnh trong phần Định tuyến mô hình và đám mây của Amp sẽ gọi điểm cuối. Tính năng này chỉ có trên gói trả phí, và gói dịch vụ là điều đầu tiên cần kiểm tra.
Kết nối Custom URL trong Model Routing của Amp — định dạng API chat-completions, base URL https://api.kunavo.com/v1, key dưới dạng bearer token — chuyển các model được ánh xạ sang một key, ở những phân khúc có tùy chọn này.
Connection type Custom URL (Model Routing → Add)
API format chat-completions OpenAI Chat Completions API, the default
Base URL https://api.kunavo.com/v1
Key sk-kn-... sent as Authorization: Bearer <key>
Headers — nothing extra is needed
Query Parameters — nothing extra is needed
Model mapping anthropic/claude-opus-4-6 -> claude-opus-4-6
anthropic/claude-fable-5 -> claude-fable-5
openai/gpt-5.6-sol -> gpt-5-6-solchat-completions giữ hậu tố /v1 trong URL cơ sở vì Amp chỉ nối thêm đường dẫn. Ví dụ minh họa trong chính tài liệu của Amp là câu xác định rõ điều này: “URL cơ sở https://api.example.com/v1 với chat-completions sẽ gửi yêu cầu đến https://api.example.com/v1/chat/completions.” Cùng trang đó bổ sung rằng URL cơ sở đã kết thúc bằng /v1 sẽ “được chấp nhận và không bị thêm lặp lại”, đồng thời biểu mẫu kết nối hiển thị URL yêu cầu khi bạn nhập — vì vậy bạn có thể kiểm tra lại URL đã ghép trước khi lưu.sk-kn-) và nạp tín dụng từ $10 — các lệnh gọi được thanh toán từ số dư đó và các lệnh gọi thất bại không bị tính phí. Sau đó, bảng điều khiển mở tại phần thiết lập Amp.Từng bước
- Tạo khóa tại
/app/keysrồi sao chép khóa — khóa chỉ hiển thị một lần. - Mở Định tuyến mô hình trong phần cài đặt cá nhân của bạn (quản trị viên không gian làm việc dùng Định tuyến mô hình của không gian làm việc để chia sẻ một kết nối với mọi thành viên), mở menu Thêm và chọn URL tùy chỉnh.
- Đặt định dạng API thành
chat-completions, dánhttps://api.kunavo.com/v1làm URL cơ sở và khóask-kn-của bạn vào trường khóa. Amp gửi khóa dưới dạngAuthorization: Bearer <key>trong mọi định dạng, đây là tiêu đề mà Kunavo dùng để xác thực, nên để trống Tiêu đề và Tham số truy vấn. - Viết ánh xạ mô hình, mỗi mẫu một dòng. Vế bên trái là ID mô hình chuẩn của Amp và vế bên phải sau
->là ID mà Kunavo nhận — cách viết của hai bên khác nhau (Amp viếtopenai/gpt-5.6-sol, Kunavo nhận diệngpt-5-6-sol), nên mũi tên ở đây là bắt buộc. Dùng bộ chọn Mô hình để chèn các ID chuẩn thay vì nhập theo trí nhớ. - Nhấn Kiểm tra quyền truy cập. Amp liệt kê các mô hình của điểm cuối khi ánh xạ có phạm vi rộng và gửi yêu cầu một token khi ánh xạ chỉ định chính xác một mô hình. Sau đó, xác nhận rằng sơ đồ định tuyến bên dưới danh sách kết nối hiển thị Kunavo phục vụ các mô hình bạn đã ánh xạ, còn mọi mô hình bạn không ánh xạ vẫn hiển thị Amp.
Đã kiểm tra đối chiếu với Tài liệu Định tuyến mô hình của Amp vào 21 tháng 9, 2026. Cài đặt của bên thứ ba có thể thay đổi; nếu tên trường ở đây không còn khớp với những gì bạn thấy, trang đó là nguồn có thẩm quyền, không phải trang này.
Xác minh trước khi gỡ lỗi ứng dụng khách
Một yêu cầu sẽ xác định liệu lỗi nằm ở endpoint, khóa hay tệp cấu hình. Nếu lệnh này trả về JSON, cùng base URL và khóa sẽ hoạt động trong Amp.
# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
-H "Authorization: Bearer sk-kn-..."Đặt model id nào vào trường
Mọi mô hình văn bản đều có thể truy cập bằng model id — danh sách đang hoạt động là GET /v1/models, còn danh mục kèm giá nằm trên trang mô hình. Mức giá tính bằng USD trên mỗi 1M token, đầu vào / đầu ra.
| ID mô hình | Kunavo vào / ra | Phù hợp ở đâu trong Amp |
|---|---|---|
gpt-5-6-sol | $2.00 / $12.00 | tác nhân chính của chế độ Medium và Puck — mô hình làm việc mặc định của Amp |
gpt-6-astra | $4.00 / $20.00 | tác nhân chính của chế độ High và tác nhân phụ Oracle trong hầu hết các chế độ |
claude-fable-5-1 | $7.00 / $35.00 | tác nhân chính của chế độ Ultra, dành riêng cho công việc khó và có yêu cầu mở |
gpt-5-6-terra | $0.70 / $4.20 | tác nhân phụ Search — truy xuất cơ sở mã, nơi khối lượng xử lý chiếm ưu thế |
claude-haiku-4-5 | $0.70 / $3.50 | View Media, mô hình của Amp dành cho hình ảnh, PDF và video — Claude đọc được hình ảnh, không đọc được video |
Những khoản phí mà kết nối không chuyển sang bên khác
Định tuyến mô hình chỉ thay đổi bên tính phí token của bạn, không thay đổi điều gì khác. Tài nguyên tính toán orb của Amp được tính riêng theo phút, nên kết nối giữ nguyên khoản phí đó — và các công cụ không phải mô hình như tìm kiếm trên web vẫn tiêu thụ tín dụng Amp bất kể mô hình được định tuyến như thế nào. Bản thân gói đăng ký Amp mở khóa tùy chọn URL tùy chỉnh là một chi phí cố định phát sinh trước token đầu tiên.
Hai mô hình Amp chạy mặc định không có trong bảng trên vì Kunavo không cung cấp chúng: các mô hình GLM phục vụ chế độ Low và tác nhân phụ Read Thread. Kết nối không thể tái tạo tuyến xử lý rẻ nhất của Amp theo cấu hình hiện có, nên ánh xạ */* sẽ âm thầm để hai mô hình đó tiếp tục dùng Amp. Đây là kết quả đúng, không phải cấu hình sai — quy tắc của chính Amp là mọi mô hình không được kết nối nào phục vụ sẽ do Amp phục vụ.
Câu hỏi thường gặp
Amp có thể dùng điểm cuối API tùy chỉnh không?
Có, thông qua kết nối URL tùy chỉnh trong phần Định tuyến mô hình, nhưng không phải trên mọi gói. Tài liệu Định tuyến mô hình của Amp nêu rằng các bộ định tuyến và cổng kết nối mô hình AI, nhóm mà URL tùy chỉnh thuộc về, đang ở giai đoạn thử nghiệm và chỉ mở quyền truy cập sớm cho khách hàng Megawatt, Gigawatt và Enterprise; Amp sẽ sớm triển khai cho tất cả mọi người nhưng không nêu ngày cụ thể. Đó là tình trạng vào ngày 21 tháng 9 năm 2026. Trên tài khoản Hobby, menu Thêm hoàn toàn không có tùy chọn này, nên gói dịch vụ là điều đầu tiên cần kiểm tra thay vì URL cơ sở.
URL cơ sở của Amp có cần kết thúc bằng /v1 không?
Điều này phụ thuộc vào định dạng API bạn chọn, và đó là lý do trường này thường bị hiểu sai. Với chat-completions, Amp chỉ nối thêm /chat/completions, nên URL cơ sở phải là gốc /v1 — ví dụ trong chính tài liệu của Amp chuyển https://api.example.com/v1 thành https://api.example.com/v1/chat/completions. Với anthropic-messages, Amp nối thêm /v1/messages, nên URL gốc không kèm đường dẫn là đúng trong trường hợp đó. Amp cũng nêu rằng URL cơ sở đã kết thúc bằng /v1 được chấp nhận và không bị thêm lặp lại; biểu mẫu kết nối hiển thị URL yêu cầu đã ghép khi bạn nhập, nên bạn có thể kiểm tra lại trước khi lưu.
Amp lưu khóa API cho điểm cuối tùy chỉnh ở đâu?
Trên máy chủ của Amp, không phải trên máy của bạn. Amp làm trung gian cho quá trình suy luận từ đám mây của mình, nên kết nối URL tùy chỉnh được cấu hình trong phần Định tuyến mô hình thuộc cài đặt tài khoản, thay vì trong tệp cấu hình cục bộ hay biến môi trường; điểm cuối bạn chỉ định phải truy cập được từ hạ tầng của Amp. Amp gửi thông tin xác thực dưới dạng tiêu đề Authorization: Bearer trong cả ba định dạng API của mình. Tài liệu tham chiếu cài đặt CLI đã công bố của Amp không có cài đặt URL cơ sở hay cài đặt khóa API, phản ánh cùng một thực tế từ phía máy khách.
Tại sao Amp vẫn dùng các mô hình của mình sau khi tôi thêm kết nối?
Vì kết nối chỉ phục vụ các mô hình có trong ánh xạ của nó, còn Amp tự phục vụ mọi mô hình khác. Kiểm tra lần lượt ba điều: kết nối có đang hoạt động không; nó nằm ở đâu trong danh sách ưu tiên — kết nối cá nhân trước, rồi đến không gian làm việc, rồi Amp, với mức ưu tiên 0 được thử trước; và ánh xạ mô hình có thực sự khớp với mô hình mà chế độ của bạn đang chạy không. Sơ đồ định tuyến bên dưới danh sách kết nối cho biết kết nối nào phục vụ từng mô hình, còn amp config model-providers check-access --provider-model chạy một lượt suy luận ngắn và báo cáo kết nối nào thực sự đã phục vụ lượt đó.
Kunavo đã thử nghiệm Amp với điểm cuối của mình chưa?
Chưa. Kunavo chưa thử nghiệm Amp khi chạy thực tế, và trang này là bản ghi lại tài liệu Định tuyến mô hình của chính Amp được đọc vào ngày 21 tháng 9 năm 2026, không phải báo cáo về một phiên chạy đã hoàn tất. Tính năng URL tùy chỉnh chỉ có trên gói Amp trả phí, nên các trường ở đây được đối chiếu với thông số kỹ thuật Amp đã công bố thay vì với một máy khách đang chạy. Nút Kiểm tra quyền truy cập của Amp xác minh thông tin xác thực với nhà cung cấp và là phép kiểm tra có tính quyết định; nếu tên trường trên trang này không còn khớp với những gì Amp hiển thị, hãy lấy trang của Amp làm căn cứ.