Pi

Một khối nhà cung cấp tùy chỉnh trong ~/.pi/agent/models.json — baseUrl, api và các model id — đưa agent lập trình terminal Pi của Earendil chạy Claude và GPT qua một key.

{
  "providers": {
    "kunavo": {
      "baseUrl": "https://api.kunavo.com/v1",
      "api": "openai-completions",
      "apiKey": "$KUNAVO_API_KEY",
      "models": [
        {
          "id": "claude-sonnet-5",
          "name": "Claude Sonnet 5",
          "reasoning": true,
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 128000
        },
        {
          "id": "claude-haiku-4-5",
          "name": "Claude Haiku 4.5",
          "input": ["text", "image"],
          "contextWindow": 200000,
          "maxTokens": 64000
        }
      ]
    }
  }
}

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. Đặt biến này trong môi trường dưới tên KUNAVO_API_KEY. Trong trường apiKey, Pi phân giải "$NAME" hoặc "${NAME}", cũng như giá trị cố định hoặc tiền tố !command. Dùng dạng có dấu ngoặc nhọn khi sau tên biến còn có văn bản cố định.
3. Tạo hoặc chỉnh sửa ~/.pi/agent/models.json rồi dán khối bên trên. Nhà cung cấp không tích hợp sẵn cần có baseUrl và giá trị api ở cấp nhà cung cấp hoặc mô hình — mã nguồn Pi từ chối tải mô hình nếu thiếu các giá trị này — còn mọi thứ khác đều không bắt buộc. Mở /model để tải lại tệp.
4. Khởi động pi, chạy /model rồi chọn một trong các ID bạn đã khai báo. Nếu chúng không xuất hiện trong danh sách, hãy kiểm tra khóa trước khi kiểm tra JSON — xem ghi chú về thứ tự phân giải ở trên.
5. Giao cho ứng dụng một tác vụ đọc và chỉnh sửa một tệp thực. Pi dựa vào việc gọi công cụ trong gần như mọi thao tác, vì vậy lần chạy đầu tiên có truy cập hệ thống tệp sẽ cho bạn biết nhiều hơn một lời chào — đồng thời có thể làm lộ ra điểm không tương thích khi truyền phát hoặc trong lược đồ công cụ, chính là loại vấn đề Kunavo chưa kiểm tra giúp bạn.

Đã kiểm tra đối chiếu với Tài liệu Choose a Model của Pi vào 1 tháng 10, 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 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.

Lựa chọn khác: anthropic-messages

Trước lần cập nhật tài liệu ngày 22 tháng 9 năm 2026, Pi ghi lại bốn giá trị cho api của nhà cung cấp tùy chỉnh — openai-completions, openai-responses, anthropic-messages và google-generative-ai. Trang mô hình sau khi cập nhật không liệt kê giá trị nào: trang này đưa ra ví dụ có openai-completions và mô tả trường hợp đó là “Endpoint tương thích với OpenAI, Anthropic hoặc Google”. Mã nguồn Pi phiên bản v0.99.2 định kiểu trường này là chuỗi tự do và chuyển xử lý đến một trong mười phần triển khai tích hợp sẵn tương ứng — bốn giá trị trên cùng với openai-codex-responses, azure-openai-responses, google-vertex, mistral-conversations, bedrock-converse-stream và pi-messages. Chỉ bốn giá trị đầu từng được ghi trong tài liệu dành cho nhà cung cấp tùy chỉnh; sáu giá trị còn lại chưa được kiểm tra ở đây. Trang này không khẳng định giá trị nào trong số đó hoạt động với endpoint bên thứ ba.

anthropic-messages là một trong bốn giá trị được ghi trong tài liệu, và Kunavo hỗ trợ giao diện Anthropic Messages cũng như giao diện tương thích OpenAI. Vì vậy, có thể khai báo tuyến này. Trang này sẽ không ghi sẵn base URL cho tuyến đó trong khối cấu hình để bạn dán vào: tài liệu Pi chưa bao giờ xác định rõ trường này cho api này. Trước ngày 22 tháng 9, tài liệu đưa ra hai cách — https://proxy.example.com/v1 trong một ví dụ và https://proxy.example.com không có hậu tố /v1 trong ví dụ khác — còn bản cập nhật hôm đó loại bỏ cả hai mà không chọn cách nào. Nếu chọn tuyến này, hãy thử một cách; nếu lệnh gọi đầu tiên trả về 404 thay vì 401, hãy sửa dòng đó.

Có ba trường trong lược đồ compat của Pi dành cho api này đáng lưu ý trước khi dùng (mã nguồn phiên bản v0.99.2). Trước hết, cần trích dẫn quy tắc duy nhất trong tài liệu áp dụng cho cả ba: các thiết lập tương thích “nên mô tả những khác biệt đã được xác minh trong cách endpoint xử lý yêu cầu hoặc phản hồi. Không bật chúng chỉ vì endpoint quảng bá khả năng tương thích với OpenAI hoặc Anthropic.”

1. compat.supportsEagerToolInputStreaming — dành cho backend từ chối truyền dữ liệu đầu vào từng công cụ ngay từ đầu.
2. compat.supportsStrictTools — endpoint có chấp nhận định nghĩa công cụ theo JSON Schema nghiêm ngặt hay không; mô hình tùy chỉnh không kế thừa thiết lập do mô hình Anthropic tích hợp sẵn khai báo.
3. compat.supportsMidConvoEffort — thay đổi mức độ suy luận giữa cuộc trò chuyện. Việc endpoint này có đáp ứng điều kiện hay không là vấn đề cần kiểm tra khi chạy thực tế; Kunavo chưa xác minh điều đó bằng cách chạy thử.

Khối openai-completions ở đầu trang này không dùng đến cả ba thiết lập trên; đó là lý do chính đáng để bắt đầu từ khối này, chứ không phải khẳng định rằng khối này hoạt động tốt hơn.