Tài liệu

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.

Cài đặt → Định tuyến mô hình → Thêm → URL tùy chỉnh
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-sol
Kiểm tra gói Amp của bạn trước mọi việc khác. Trang Định tuyến mô hình của Amp nêu vào ngày 2026-09-21 rằng “Các bộ định tuyến và cổng kết nối mô hình AI đ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. Chúng tôi sẽ sớm triển khai cho tất cả mọi người.” Kết nối URL tùy chỉnh thuộc nhóm này, nên trên tài khoản Hobby, menu Thêm sẽ không có tùy chọn đó. Amp không công bố ngày triển khai và trang này cũng không dự đoán ngày đó.
Kunavo chưa chạy Amp với điểm cuối này. Mọi trường ở trên đều được lấy từ tài liệu của chính Amp, không phải từ một phiên chạy mà bất kỳ ai ở đây đã hoàn tất — tính năng này chỉ có trên gói Amp trả phí. Hãy xem đây là bản ghi lại thông số kỹ thuật của Amp và để Kiểm tra quyền truy cập xác nhận rằng kết nối hoạt động.
chat-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.
Các mô hình hệ thống Đọc chính tả và Giọng nói thời gian thực của Amp là những tính năng giọng nói, và Kunavo không cung cấp mô hình chuyển giọng nói thành văn bản hay mô hình chuyển văn bản thành giọng nói. Kết nối URL tùy chỉnh ở đây không thể phục vụ bất kỳ tính năng nào trong số đó; hãy để Amp xử lý các dòng này.
Chưa có khóa? Tạo tài khoản Kunavo, tạo khóa (bắt đầu bằng 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

  1. Tạo khóa tại /app/keys rồi sao chép khóa — khóa chỉ hiển thị một lần.
  2. 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.
  3. Đặt định dạng API thành chat-completions, dán https://api.kunavo.com/v1 làm URL cơ sở và khóa sk-kn- của bạn vào trường khóa. Amp gửi khóa dưới dạng Authorization: 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.
  4. 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ết openai/gpt-5.6-sol, Kunavo nhận diện gpt-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ớ.
  5. 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.

Đây là phiên bản ngắn. Hướng dẫn đầy đủ — lựa chọn mô hình, chi phí của một phiên thực tế và các trường hợp lỗi — nằm trong chi phí của bản thân Amp và những khoản phí mà kết nối chuyển hoặc không chuyển sang bên khác.

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ìnhKunavo vào / raPhù hợp ở đâu trong Amp
gpt-5-6-sol$2.00 / $12.00tá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.00tá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.00tá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.20tá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.50View 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
Thanh toán theo token từ số dư trả trước, không có phí hàng tháng — xem trang Thanh toán. Với ngữ cảnh lặp lại — chiếm phần lớn dữ liệu mà trình chỉnh sửa hoặc ứng dụng trò chuyện gửi đi — bộ nhớ đệm prompt ảnh hưởng đến hóa đơn nhiều hơn lựa chọn mô hình.

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ứ.