Oh My Pi

Một khối nhà cung cấp trong ~/.omp/agent/models.yml — baseUrl, api, apiKey — trỏ Oh My Pi tới Kunavo, và discovery điền danh sách model từ GET /v1/models.

providers:
  kunavo:
    baseUrl: https://api.kunavo.com/v1
    api: openai-completions
    apiKey: KUNAVO_API_KEY       # an env-var name; literal text also works
    discovery:
      type: openai-models-list   # reads GET /v1/models

# Prefer a fixed list to a discovered one? Drop the discovery block and
# declare ids instead. Omitted metadata defaults to a 128,000-token context
# window and a 16,384-token output limit, so set the real numbers from
# /models when they differ.
#
#     models:
#       - id: claude-sonnet-5
#         name: Claude Sonnet 5
#         contextWindow: ...
#         maxTokens: ...

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. Xuất biến này thành KUNAVO_API_KEY trong shell dùng để khởi chạy omp. Trước tiên, omp phân giải apiKey thành tên biến môi trường; nếu không tìm thấy, nó sẽ coi nguyên văn đó là khóa. Vì vậy, gõ sai tên biến sẽ không báo lỗi mà âm thầm tải cấu hình sai, rồi thất bại ở yêu cầu đầu tiên. Giá trị bắt đầu bằng ! sẽ được chạy như một lệnh shell — đó là cách dùng kiểu 1Password.
3. Đặt khối trên vào ~/.omp/agent/models.yml. Bạn tự chọn provider id — ở đây là kunavo — và nó sẽ trở thành phần đầu của mọi bộ chọn.
4. Chạy omp models kunavo để tải tệp và chỉ liệt kê nhà cung cấp này. Lỗi YAML hoặc schema sẽ in models.yml validation failed cùng trường gây lỗi; omp models refresh kunavo buộc thực hiện một lần khám phá mới thay vì dùng danh mục đã lưu trong bộ nhớ đệm.
5. Kiểm tra bằng bộ chọn chính xác: omp -p --model kunavo/claude-sonnet-5 "Reply with only OK". Sau đó khởi chạy omp, nhập /model và gán id bạn muốn cho Default — trung tâm mô hình sẽ tải lại models.yml khi mở. /switch chỉ thay đổi phiên hiện tại.

Đã kiểm tra đối chiếu với Trang Providers của omp 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 Oh My Pi.

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

Khám phá: chọn kiểu nào và mục nào xuất hiện trong bộ chọn

omp cung cấp sáu giá trị discovery.type và có hai giá trị trông phù hợp với gateway. Nhưng chỉ một giá trị đúng. proxy được mô tả dành cho “proxy hỗn hợp OpenAI/Anthropic có các hàng mô hình khai báo supported_endpoint_types”, và nó xác định giao thức của từng mô hình dựa trên trường đó. GET /v1/models của Kunavo không công bố trường này, nên với proxy, mọi hàng sẽ dùng lại api ở cấp nhà cung cấp — hoặc bị loại nếu không đặt giá trị này. openai-models-list, được mô tả là “endpoint GET /v1/models tương thích OpenAI tổng quát”, là lựa chọn cần dùng; đó là lý do khối cấu hình trên giữ lại api: openai-completions: quy tắc của omp là “ngoại trừ proxy, khám phá cần có api ở cấp nhà cung cấp”.

Có một hệ quả cần biết trước khi mở bộ chọn. Danh sách mô hình Kunavo bao gồm toàn bộ danh mục được bật, vì vậy nhà cung cấp được khám phá sẽ hiển thị các id hình ảnh, video và nhạc bên cạnh các id trò chuyện, trong khi giao thức trò chuyện không thể gọi chúng. Kunavo công bố context_length trên các hàng trò chuyện — đây là trường mà tính năng khám phá tổng quát của omp đọc sau max_model_len, theo tài liệu mô hình — nhưng bỏ qua trường này trên các hàng đa phương tiện, nên những hàng đó sẽ nhận giá trị mặc định 128.000 token của omp thay vì một con số thực. Nếu muốn bộ chọn ngắn gọn và chính xác, hãy bỏ khối khám phá và khai báo ba hoặc bốn id bạn thực sự dùng.

omp cũng hỗ trợ giao thức anthropic-messages, và Kunavo trả lời tại /v1/messages. Trang này không đưa ra khối cấu hình cho cặp đó: hai trang được trích dẫn ở đây xác định dạng URL cơ sở cho tuyến tương thích OpenAI nhưng không nói cách xử lý hậu tố /v1 ở tuyến Anthropic, trong khi mục đích của khối cấu hình là để người đọc có thể sao chép và dùng ngay. Nếu chọn cách đó,disableStrictTools: true là câu trả lời trong tài liệu cho trường hợp lệnh gọi công cụ thất bại với lỗi 400 trên endpoint tương thích Anthropic.